NWADReadRecord(3nw)


NWADReadRecord -- reads a specified record

Synopsis

   #include <nwaudit.h> 
   or 
   #include <nwnet.h> 
   

N_EXTERN_LIBRARY NWRCODE NWADReadRecord (nptr recordHandle, nuint16 maxSize, nint16 direction, pnuint8 buffer, pnuint16 bufferSize, pnuint8 eofFlag, pnuint32 offsetPtr);

Description

The parameters are as follows:

recordHandle
(IN) Specifies the record handle allocated in NWADOpenRecordFile.

maxSize
(IN) Specifies the size of the buffer passed into the call. NWADReadRecord will write beyond the ned of the specified buffer size. Typically, size is 512 bytes.

direction
(IN) Specifies whether to get the previous or the next record:

-1 = Get previous record
1 = Get next record

buffer
(IN/OUT) Points to a buffer to contain the record.

bufferSize
(OUT) Points to the size of data contained in the buffer.

eofFlag
(OUT) Points to a flag indicating whether the end of file has been reached:

1 = End of file
0 = More file to be read

offsetPtr
(IN) Points to a book marker indicating where the previously read record is located.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8983
Auditing Hardware Error

0x8984
Auditing Not Supported

0x8997
Auditing Not Enabled

0x8998
VOLUME_DOES_NOT_EXIST

0x89DE
PASSWORD_HAS_EXPIRED_NO_GRACE

Services

Auditing

NCP calls

0x2222 88 25 Read Auditing File
0x2222 104 224 Read Auditing File

References

NWADOpen(3nw), NWADOpenRecordFile(3nw), NWADCloseRecordFile(3nw),


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.