NWAddRecordToAuditingFile

Allows NLM applications to add records to the audit file.

Local Servers:blocking
Remote Servers:N/A
NetWare Server:4.x, 5.x, 6.x
Platform:NLM
Service:Server-Based Auditing

Syntax

   #include <nlm\nwtypes.h>  
   #include <nwaudnlm.h>  
    
   int  NWAddRecordToAuditingFile (  
      LONG    volumeNumber,  
      LONG    recordType,  
      LONG    stationNumber,  
      LONG    statusCode,  
      BYTE   *data,  
      LONG    dataSize);

Parameters

volumeNumber
(IN) Specifies the volume for which to record the related record.
recordType
(IN) Specifies the type of record to be added to the audit file. Types lower than 65,536 are defined by the NLM™ application. Types greater than 65,536 are reserved.
stationNumber
(IN) Specifies the server connection number.
statusCode
(IN) Specifies the code to be written into the record.
data
(IN) Points to the data to be written.
dataSize
(IN) Specifies the size of the data to be written.

Return Values

Decimal

Hex

Constant

0

(0x00)

Successful

151

(0x97)

ERR_AUDITING_NOT_ENABLED

168

(0xA8)

ERR_AUDITING_NO_RIGHTS

Remarks

Before calling the NWAddRecordToAuditingFile function, use the Auditcon utility to set "NLM Add Audit Record" to "Audited" (in "Audit by server events").

Retrieve the record with the Auditcon utility or a client application.

NOTE:To avoid conflicts between applications, developers should contact Developer Support (1-800-REDWORD) when assigning a record type.

See Also

NWGetAuditingIdentity, NWSetAuditingIdentity