srv_setcollen
Specifies the current data length in bytes of a variable-length column or a column that allows NULL values.
Syntax
int srv_setcollen (
SRV_PROC * srvproc,
int column,
int len );
Arguments
srvproc
Is a pointer to the SRV_PROC structure that is the handle for a particular client connection. The structure contains information the ODS Library uses to manage communication and data between the Open Data Services server application and the client.
column
Indicates the number of the column for which the data length is being specified. Columns are numbered beginning with 1.
len
Indicates the length, in bytes, of the column data. A length of 0 means the column data value is null.
Returns
SUCCEED or FAIL.
Remarks
Each column of the row must first be defined with srv_describe. The column data length is set by the last call to srv_describe or srv_setcollen. If variable-length data (null-terminated data) changes for a row, srv_setcollen must be used to set it to the new length before calling srv_sendrow. For a column that allows null values, srv_describe must have been called with desttype set to a data type that allows nulls (like SRVINTN) and null data is specified by calling srv_setcollen with len set to 0. Zero length data cannot be specified using Open Data Services API.
Note that when the data type of the column is variable-length, len is not checked. This function returns FAIL if called for a fixed-length column.