srv_langcpy

Copies part of the language request buffer.

Important This Open Data Services function or macro is only supported in Microsoft® SQL Server™ version 7.0 for backward compatibility.

For more information about Open Data Services functions or macros supported for backward compatibility, see Open Data Services (Level 3).

Syntax

long srv_langcpy (
SRV_PROC * srvproc,
long start,
long nbytes,
DBCHAR * buffer );

Arguments

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 information the ODS Library uses to manage communication and data between an Open Data Services server application and the client.

start

Indicates where to start copying characters from the request buffer. Command buffer characters are numbered beginning with 0.

nbytes

Specifies the number of bytes to copy. If nbytes is -1, srv_langcpy copies the number of bytes available in the request buffer. If there are fewer than nbytes bytes available to copy, srv_langcpy copies all the bytes in the request buffer.

buffer

Provides a DBCHAR pointer to the developer-supplied buffer in which to copy the bytes.

Returns

The number of bytes copied. If there is no current language request from the client, returns -1.

Remarks

The srv_langcpy function null-terminates the part of the language request buffer copied into buffer. This function assumes that buffer is large enough to handle (nbytes + 1) bytes. The request buffer can contain an ASCII string.