srv_sendrow

Transmits a row of data to the client.

Syntax

int srv_sendrow ( SRV_PROC * srvproc );

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.

Returns

SUCCEED or FAIL.

Remarks

The srv_sendrow function is called once for each row sent to the client. All rows must be sent to the client before any messages, status values, or completion statuses are sent with srv_sendmsg, srv_status, or srv_senddone.

Sending a row that hasn't had all its columns defined with srv_describe causes the Open Data Services server application to raise an informational error message and return FAIL to the client. In this case, the row is not sent.

Note Open Data Services does not support sending compute rows to the client. Also, if a row containing text or image data is sent to the client, the text pointer and text timestamp are not included.

See Also

This entry For information about
srv_describe Describing a result row column
srv_senddone Sending a results completion message to the client
srv_sendmsg Sending a message to the client
srv_setcollen Specifying the current length of a column's data