home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbwritepage.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.1 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89              dbwritepage
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbwritepage
  6.  
  7.   FUNCTION:
  8.        Write a page of binary data to SQL Server.
  9.  
  10.   SYNTAX:
  11.        RETCODE dbwritepage(dbproc, dbname, pageno, size, buf)
  12.  
  13.        DBPROCESS *dbproc;
  14.        char      *dbname;
  15.        DBINT     pageno;
  16.        DBINT     size;
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbwritepage             Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.        BYTE      buf[];
  27.  
  28.   COMMENTS:
  29.  
  30.        o dbwritepage() writes a page of binary data to SQL Server.  This
  31.          routine is primarily useful for examining and repairing damaged
  32.          database pages.  After calling dbwritepage(), the DBPROCESS may
  33.          contain  some  error or informational messages from SQL Server.
  34.          These messages may be accessed through a user-supplied  message
  35.          handler.
  36.  
  37.  
  38.          WARNING  ________________________________________________________
  39.          ||  Use this routine only if you are absolutely sure you know    |
  40.          |  what you are doing!                                          |
  41.          |_______________________________________________________________||
  42.  
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89              dbwritepage
  47.   ______________________________________________________________________
  48.  
  49.   PARAMETERS:
  50.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  51.            connection for a particular front-end/SQL Server process.  It
  52.            contains all the information that DB-Library uses  to  manage
  53.            communications and data between the front end and SQL Server.
  54.        dbname -  The name of the database of interest.
  55.        pageno -  The number of the database page to be written.
  56.        size -   The  number  of  bytes  to  be  written  to  SQL Server.
  57.            Currently, SQL Server database pages are 2048 bytes long.
  58.        buf -  A pointer to a buffer which holds the data to be written.
  59.  
  60.   RETURNS:
  61.        SUCCEED or FAIL.
  62.  
  63.   SEE ALSO:
  64.        dbmsghandle, dbreadpage
  65.  
  66.  
  67.