srv_sendstatus

Sends a status value to the client in response to a request.

Syntax

int srv_sendstatus (
SRV_PROC * srvproc,
DBINT value );

where

srvproc

Is a pointer to the SRV_PROC structure that is the handle for a particular client connection (in this case, the handle that received the language request). The structure contains the information that the ODS Library uses to manage communication and data between the Open Data Services server application and the client.

value

Indicates the status of the request; 0 indicates that the request completed normally.

Returns

SUCCEED or FAIL

Remarks

When a request is received, a developer-supplied event handler function is called to service it. Part of the response to a request can be to return a status value.

A status value can be sent after all rows, if any, have been sent to the client with srv_sendrow and before the completion status is sent with srv_senddone. Only one status value can be sent for each set of results. This is equivalent to the Transact-SQL RETURN command.

See Also