dbgetpacket

Returns the tabular data stream (TDS) packet size currently in use.

Syntax

UINT dbgetpacket ( PDBPROCESS dbproc );

Arguments

dbproc

Is the DBPROCESS structure that is the handle for a particular workstation/ Microsoft® SQL Server™ process. It contains all the information that DB-Library uses to manage communications and data between the workstation and SQL Server.

Returns

The TDS packet size currently in use.

Remarks

To determine the TDS packet size in use, an application should call dbgetpacket after dbopen.

You can change the TDS packet size by using DBSETLPACKET, which sets the packet size field in the LOGINREC structure.

If the call to dbgetpacket fails (for example, when dbproc is null), dbgetpacket returns 0. Other than the failure case of 0, however, the call should never return less than 512 bytes.

See Also