srv_sfield

Returns a field from an SRV_SERVER structure.

Syntax

DBCHAR * srv_sfield (
SRV_SERVER * server,
int field,
int * len );

where

server

Is a pointer to an SRV_SERVER structure. Use srv_init to get this pointer.

field

Specifies which server field to return. srv_sfield supports all configuration options supported by srv_config. srv_sfield also supports the following additional server fields:

SRV_SERVERNAME

The name of the Open Data Services server application server. This name is set with srv_init.

SRV_VERSION

Returns a string representing the version of Open Data Services in use. The version string has the format xx.xx.xx.xx (for example, 6.00.01.02). The first two sets of digits represent the internal version number. The final set of digits is a level identifier. Applications can check the version of the ODS Library, OPENDS60.DLL, at run time, to ensure that its version information is equal to or greater than the version used to develop the application.

For more information about supported configuration options, see srv_config.

len

Specifies a pointer to an integer variable that contains the length of the value for field. If len is NULL, the length of the string is not returned.

Returns

A DBCHAR pointer to a null-terminated string containing the field value. The string length is returned in len. If the field is empty, a valid DBCHAR pointer to an empty string is returned and len is set to 0. If the field is unknown, NULL is returned and len is set to -1.

Remarks

This function returns a pointer to a null-terminated string containing the current value for the field in the server structure.

See Also