Syntax

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

Parameters

addressType

(IN) One of the following currently supported address types: ASCII_STRING_NET_ADDRESS_TYPE 0x00 (string) ETHERNET_NET_ADDRESS_TYPE 0x00 xxxxxxxx:xxxxxxxxxx

networkAddress

(IN) Points to a buffer that contains the network address of an auditing identity. If this pointer is NULL, the auditing identity for the current thread group is cleared.

identityName

(IN) Points to a buffer that contains the name of an auditing identity (up to 255 characters long). If this pointer is NULL, the auditing identity for the current thread group is cleared.

Return Values

Remarks

Te NWSetAuditingIdentitys function links the current thread group to a workstation address and a user name. The F2 audit specification for security auditing requires that the audit trail events identify the user name and the workstation address of the event initiator. NLM developers can use this function to ensure F2 auditing compliance. The auditing identity is tracked on a thread group basis; therefore, all threads in a thread group are audited as the single identity set by this function.

See Also

NWGetAuditingIdentity