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.