TipcSrvMonClientTimeGetWatch

Name

TipcSrvMonClientTimeGetWatch — determine if this RTclient is watching time information in an RTclient

Synopsis

T_BOOL TipcSrvMonClientTimeGetWatch(srv, client_name, watch_status_return) 
T_IPC_SRV srv; 
T_STR client_name; 
T_BOOL *watch_status_return; 

Arguments

srv — connection handle to RTserver

client_name — name of RTclient to get watch status for (wildcard names allowed, or use T_IPC_MON_ALL to indicate a watch of all RTclients matching the value of Monitor_Scope)

watch_status_return — storage for watch status

Return Values

TRUE if the RTclient time information watch status was successfully retrieved, FALSE otherwise.

Diagnostics

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

Description

TipcSrvMonClientTimeGetWatch determines whether this RTclient is watching time information in the client_name RTclient. The client_name argument can be the unique subject name of a single RTclient, a wildcarded subject name to match many RTclients, or T_IPC_MON_ALL to watch all RTclients in the project that match the value of the Monitor_Scope option. The watch status controls whether the RTclient receives a MON_CLIENT_TIME_STATUS message each time the current time changes in the watched RTclient.

Each MON_CLIENT_TIME_STATUS message contains seven fields:

To set whether this RTclient is watching RTclient time information, use TipcSrvMonClientTimeSetWatch. To poll once for RTclient time information, use TipcSrvMonClientTimePoll.

For an example of how MON_CLIENT_TIME_STATUS messages can be used, see the RTmon GDI Watch Client Time window.

Caution

If TipcSrvMonClientTimeGetWatch returns FALSE, it does not store a value in watch_status_return.

See Also

TipcSrvMonClientTimePoll, TipcSrvMonClientTimeSetWatch

Examples

This example uses TipcSrvMonClientTimeGetWatch to get the status of watching time information in the primary RTclient:

T_BOOL watch_status; 
 
if (!TipcSrvMonClientTimeGetWatch(srv, "primary", &watch_status)) 
{ 
  return;  /* error */ 
} 
TutOut("This process is %s time information in primary.\n", 
       watch_status ? "watching" : "not watching");