Advantage Client Engine
Determines if an Advantage server is available
UNSIGNED32 |
AdsIsServerLoaded (UNSIGNED8 *pucLocation, UNSIGNED16 *usServerType); |
pucLocation (I) |
Null terminated string containing drive letter or server name to check. If the application uses a server name as the parameter, it must include the share or volume name as well. For example, use "\\server\share" or "\\server\vol:". |
usServerType (O) |
This will be set to the server type if an Advantage server is available to access data at the specified location. The server types are ADS_REMOTE_SERVER and ADS_LOCAL_SERVER. If no Advantage server is available, usServerType will be set to 0. |
AE_NO_DRIVE_CONNECTION |
An Advantage server could not be located for the indicated path. |
AdsIsServerLoaded is used to check if an Advantage server is available to access data on the specified machine. AdsIsServerLoaded uses the server types specified in AdsSetServerType to determine which Advantage server types to check. If no server types have been specified by AdsSetServerType, ADS_REMOTE_SERVER will be checked. If AdsIsServerLoaded returns a non-zero value in the usServerType parameter, an Advantage server is available, and it results in a connection to the server.
AdsIsServerLoaded returns ADS_REMOTE_SERVER in the usServerType parameter if a successful connection is made via an Advantage Database Server running on Novell NetWare, Microsoft Windows NT/2000/2003, or Microsoft Windows 95/98/ME.
AdsIsServerLoaded returns ADS_LOCAL_SERVER in the usServerType parameter if a successful connection is made via the Advantage Local Server.
AdsIsServerLoaded returns an error code in the return value if unable to connect to the specified location via an Advantage server.
Note This function does not check for the Advantage Internet Server since connection to the Advantage Internet Server requires an Advantage Data Dictionary, username, and password.