NWSubmitAccountNote

Adds a note about an accounting transaction to an audit record

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Accounting

Syntax

   #include <nwacct.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWSubmitAccountNote ( 
      NWCONN_HANDLE       conn,  
      nuint16             objType,  
      const nstr8 N_FAR  *objName,  
      nuint16             serviceType,  
      nuint16             noteType,  
      const nstr8 N_FAR  *note); 
   
   

Pascal Syntax

   uses calwin32 
    
   Function NWSubmitAccountNote   
     (conn : NWCONN_HANDLE; 
      objType : nuint16; 
      objName : pnstr8; 
      serviceType : nuint16; 
      noteType : nuint16; 
      note : pnstr8 
   ) : NWCCODE; 
   
   

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objType
(IN) Specifies the type of the object for which the note is being submitted.
objName
(IN) Points to the name of the object to receive the note (48 character maximum or will be truncated).
serviceType
(IN) Specifies the object type of the charging account server.
noteType
(IN) Specifies the note type (255 character maximum or will be truncated).
note
(IN) Points to a note to be added to an audit record.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8901

ERR_INSUFFICIENT_SPACE

0x890A

NLM_INVALID_CONNECTION

0x8996

SERVER_OUT_OF_MEMORY

0x89C0

NO_ACCOUNTING_PRIVILEGES

0x89C1

LOGIN_DENIED_NO_ACCOUNT_BALANCE

0x89C4

ACCOUNTING_DISABLED

0x89E8

WRITE_PROPERTY_TO_GROUP

0x89EA

NO_SUCH_MEMBER

0x89EB

NOT_GROUP_PROPERTY

0x89EC

NO_SUCH_SEGMENT

0x89EF

INVALID_NAME

0x89F0

WILD_CARD_NOT_ALLOWED

0x89FC

NO_SUCH_OBJECT

0x89FF

HARDWARE_FAILURE

Remarks

objType and objName must uniquely identify the object and cannot contain wildcard characters.

serviceType usually contains the object type of the charging account server. The common server object types are listed below:

   Object           Type                High-Low Format 
   Job Server       OT_JOB_SERVER       0x0500 
   Print Server     OT_PRINT_SERVER     0x0700 
   Archive Server   OT_ARCHIVE_SRVER    0x0900
   

noteType contains the number of the note type. Note types are administered by Novell and are listed below:

   Note      Description Type  
   1         Connect time charge 
   2         Disk storage charge 
   3         Log in note 
   4         Log out note 
   5         Account locked note 
   6         Server time modified note
   

Developers should contact Novell for unique note types. Note types greater than 8000H are reserved.

NOTE:note contains the entry the server adds to the audit record. The audit record is contained in SYS:SYSTEM\NET$ACCT.DAT.

NCP Calls

See Also

NWSubmitAccountCharge, NWSubmitAccountHold