TipcConnGetUser

Name

TipcConnGetUser — get the user name of a connection’s peer process

Synopsis

T_BOOL TipcConnGetUser(conn, user_return) 
T_IPC_CONN conn; 
T_STR *user_return; 

Arguments

conn — connection to get user name from

user_return — storage for connection user name

Return Values

TRUE if the user name was successfully retrieved from the connection, FALSE otherwise.

Diagnostics

If TipcConnGetUser fails, it returns FALSE and sets the global SmartSockets error number to:

Description

TipcConnGetUser gets the user name of a connection’s peer process (the process that this process is communicating with over the connection). The peer process user name can be useful for diagnostic purposes.

Caution

If TipcConnGetUser returns FALSE, it does not store a value in user_return.

The value stored in user_return points directly into an internal data structure and should not be modified.

See Also

TipcConnGetArch, TipcConnGetNode, TipcConnGetPid, TipcConnGetUniqueSubject

Examples

This example prints the user name of a connection’s peer process:

T_STR user; 
 
if (!TipcConnGetUser(conn, &user)) { 
  return;  /* error */ 
}  
 
TutOut("Connection peer process user name is <%s>.\n", user);