dbreadpage

Description

Read a page of binary data from the server.

Syntax

DBINT dbreadpage(dbproc, dbname, pageno, buf)
 
DBPROCESS    *dbproc;
char                   *dbname;
DBINT                 pageno;
BYTE                   buf[];

Parameters

dbproc

A pointer to the DBPROCESS structure that provides the connection for a particular front-end/server process. It contains all the information that DB-Library uses to manage communications and data between the front end and server.

dbname

The name of the database of interest.

pageno

The number of the database page to be read.

buf

A pointer to a buffer to hold the received page data. Adaptive Server pages are currently 2048 bytes long.

Returns

The number of bytes read from the server. If the operation was unsuccessful, dbreadpage returns -1.

Usage

WARNING! Use this routine only if you are absolutely sure you know what you are doing!

See also

dbmsghandle, dbwritepage