NWGetAuditingIdentity

Assigns an auditing identity to a thread group

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

Syntax

   #include #include <nlm\nwtypes.h>  
   #include <nwaudnlm.h>  
    
   int  NWGetAuditingIdentity (  
      LONG   *addressType,  
      BYTE   *networkAddress,  
      char   *identityName);

Parameters

addressType
(OUT) One of the following currently supported address types: ASCII_STRING_NET_ADDRESS_TYPE 0x00 (string) ETHERNET_NET_ADDRESS_TYPE 0x02.
networkAddress
(OUT) Points to a buffer that is to receive a network address of the same type received in the address type parameter.
identityName
(OUT) Points to a buffer that is to receive an ASCIIZ string of the name of the identity being audited for the current thread group (this string can be up to 255 characters long). If this parameter is not set, it receives IDENTITY_HAS_NOT_BEEN_SET (0xFF).

Return Values

Decimal

Hex

Constant

0

 

Successful

255

(0xFF)

ERR_FAILURE

Remarks

The NWGetAuditingIdentity function returns the auditing identity that has been assigned to a thread group. If no auditing identity has been previously set, ERR_FAILURE is returned and networkAddress and identityName are NULL-length.

See Also

NWSetAuditingIdentity