TipcSrvConnGetProject

Name

TipcSrvConnGetProject — get the project of the connection to RTserver

Synopsis

T_BOOL TipcSrvConnGetProject(srv, project_return) 
T_IPC_SRV srv; 
T_STR *project_return; 

Arguments

srv — connection to RTserver

project_return — returned project

Return Values

TRUE if the project was successfully retrieved for the connection to RTserver, FALSE otherwise.

Diagnostics

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

Description

TipcSrvConnGetProject gets the project of the connection to RTserver.

Caution

The storage pointed to by project_return should not be modified or freed. The storage is thread safe, but may be overwritten by subsequent calls to SmartSockets APIs within the same thread. If you wish to preserve the value, you should make a copy of the value.

See Also

TipcSrvConnSetProject

Examples

This example gets the RTclient’s project:

T_STR project; 
 
if (!TipcSrvConnGetProject(srv, &project)) { 
  return;  /* error */ 
}