SubmitAccountNote

Adds a note about an object’s account to an audit record (For cross-platform functionality, see Developing NLMs with Cross-Platform Functions ( NDK: NLM Development Concepts, Tools, and Functions) and call NWSubmitAccountNote)

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
Service:Bindery-Based Accounting

Syntax

   #include <\nlm\nit\nwaccntg.h> 
     
   int SubmitAccountNote (  
      WORD    binderyObjectType,  
      char   *binderyObjectName,  
      WORD    serviceType,  
      WORD    commentType,  
      char   *comment)

Parameters

binderyObjectType
(IN) Specifies the type of bindery object for which the request is being made (see Object Type for specific object types).
binderyObjectName
(IN) Specifies the string containing the name of the bindery object for which the request is being made (maximum 48 characters, including the NULL terminator).
serviceType
(IN) Identifies the type of service for which the request is being made (usually the object type of the charging account server).
commentType
(IN) Indicates the type of comment in the comment parameter.
comment
(IN) Specifies the comment associated with the object’s account.

Return Values

Decimal

Hex

Constant

0

(0x00)

ESUCCESS

192

(0xC0)

ERR_NO_ACCOUNT_PRIVILEGES

196

(0xC4)

ERR_ACCOUNTING_DISABLED

Remarks

The binderyObjectType and binderyObjectName parameters must uniquely identify the bindery object and must not contain wildcard characters. The binderyObjectName parameter is a NULL-terminated string (maximum 48 characters, including the NULL terminator). Only printable characters can be used. Slashes, backslashes, colons, semicolons, commas, asterisks, spaces, and question marks are prohibited.

The serviceType parameter usually contains the object type of the charging account server.

The commentType parameter contains the type of the comment in the comment parameter. Comment types are administered by Novell and are listed below.

  • Connect Time Charge
  • Disk Storage Charge
  • Log In Note
  • Log Out Note
  • Account Locked Note
  • Server Time Modified Note

Developers should contact Novell for unique comment types. Comment types greater than 0x8000 are reserved for experimental purposes. The description is located in the NET$REC.DAT file.

The comment parameter contains the entry that the server makes in the audit record. The audit record is contained in the SYS:SYSTEM\NET$ACCT.DAT file. Comments are restricted to 256 bytes, including the NULL terminator.