gclib  2.0.8
Communications API for Galil controllers and PLCs

◆ GServerStatus()

GReturn GCALL GServerStatus ( GCStringOut  status,
GSize  status_len 
)

Uses GUtility(), G_UTIL_GCAPS_SERVER_STATUS to get information on the local server name and if it is published to the local network.

Note
This function is only available on Windows 10 and Linux.
Parameters
statusThe buffer to hold the status of the local gcaps server
status_lenThe length of the status buffer

This function is used to find the status of your local gcaps server. Use this function to determine the name your server is currently using, and whether or not your gcaps server is currently set to "Discoverable" or "Invisible"

The status buffer will be filled in the form of "[Server Name], [Discoverable]"

For example, for a server with the name "Example Server" that is set to "Discoverable", the status buffer would contain "Example Server, true".

Attention
This function will always use your local gcaps server, regardless of which server you have set as your active server.
Returns
The success status or error code of the function. See gclib_errors.h for possible values.

Definition at line 149 of file gclibo.c.

References G_GCAPS_OPEN_ERROR, G_NO_ERROR, G_UTIL_GCAPS_SERVER_STATUS, and GUtility().