TipcConnGetPid

Name

TipcConnGetPid — get the process ID of a connection’s peer process

Synopsis

T_BOOL TipcConnGetPid(conn, pid_return) 
T_IPC_CONN conn; 
T_INT4 *pid_return; 

Arguments

conn — connection from which to get process ID

pid_return — storage for connection process ID

Return Values

TRUE if the process ID was successfully retrieved from the connection, FALSE otherwise.

Diagnostics

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

Description

TipcConnGetPid gets the operating system process ID of a connection’s peer process (the process with which this process is communicating through the connection). The peer process ID can be useful for diagnostic purposes.

Caution

If TipcConnGetPid returns FALSE, it does not store a value in pid_return.

See Also

TipcConnGetArch, TipcConnGetNode, TipcConnGetUniqueSubject, TipcConnGetUser

Examples

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

T_INT4 pid; 
 
if (!TipcConnGetPid(conn, &pid)) { 
  return;  /* error */ 
}  
 
TutOut("Connection peer process ID is <%d>.\n", pid);