srv_symbol

Converts an Open Data Services token value to a readable string.

Syntax

DBCHAR * srv_symbol (
int type,
int symbol,
int * len );

Arguments

type

Is the type of the symbol token.

 

Value (type)	Token (symbol)
SRV_DATATYPE	An Open Data Services data type token returned by the Open Data Services function srv_paramtype (SRVCHAR, for example) or a DB-Library data type token returned by functions such as dbcoltype (SQLCHAR, for example).
SRV_EVENT	An event token passed to srv_handle (SRV_CONNECT, for example).
SRV_DONE	A “done” status token passed to srv_senddone (SRV_DONE_FINAL, for example).
SRV_ERROR	An error-severity token passed to the error handler of the Open Data Services application and installed by srv_errhandle (SRV_INFO, for example).

symbol

Is the actual Open Data Services or DB-Library token value.

len

Is a pointer to an integer variable that contains the length of the returned string.

Returns

A pointer to a null-terminated character string that is a readable translation of an Open Data Services token value. If type or symbol is unknown, the function returns NULL and sets len to -1. The returned pointer points to space that is never overwritten, so it is safe to call this function more than once in the same statement. To free memory allocated by a call to srv_symbol, you must call the Microsoft® Windows NT® function LocalFree.

Remarks

This function returns a pointer to a null-terminated string that describes an Open Data Services token value.

See Also