NWSubmitAccountCharge

Charges an amount against an object’s balance and either relinquishes a hold or reduces the hold by the charge amount

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 NWSubmitAccountCharge ( 
      NWCONN_HANDLE       conn,  
      nuint16             objType,  
      const nstr8 N_FAR  *objName,  
      nuint16             serviceType,  
      nint32              chargeAmt,  
      nint32              holdCancelAmt,  
      nuint16             noteType,  
      const nstr8 N_FAR  *note);

Pascal Syntax

   uses calwin32 
    
   Function NWSubmitAccountCharge   
     (conn : NWCONN_HANDLE; 
      objType : nuint16; 
      objName : pnstr8; 
      serviceType : nuint16; 
      chargeAmt : nint32; 
      holdCancelAmt : nint32; 
      noteType : nuint16; 
      note : pnstr8 
   ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objType
(IN) Specifies the type of the object to be charged.
objName
(IN) Points to a string containing the name of the object whose account is to be charged (48 character maximum or will be truncated).
serviceType
(IN) Specifies the type of service for which the charge is being made.
chargeAmt
(IN) Specifies the amount to be charged to the object account balance.
holdCancelAmt
(IN) Specifies the amount the hold will be reduced (set to zero if there are no holds).
noteType
(IN) Specifies the note type to be written to the audit report.
note
(IN) Points to a note associated with the charge and stored as an audit record (255 character maximum or will be truncated).

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

0x8988

INVALID_FILE_HANDLE

0x8994

NO_WRITE_PRIVILEGES_OR_READONLY

0x8996

SERVER_OUT_OF_MEMORY

0x89A2

READ_FILE_WITH_RECORD_LOCKED

0x89C0

NO_ACCOUNTING_PRIVILEGES

0x89C1

LOGIN_DENIED_NO_ACCOUNT_BALANCE

0x89C2

LOGIN_DENIED_NO_CREDIT

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

0x89FE

BINDERY_LOCKED

0x89FF

HARDWARE_FAILURE

Remarks

NWSubmitAccountCharge can write a note about the transaction in an audit record (optional). The charge and hold amounts do not have to be the same.

objType and objName must uniquely specify 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®, Inc. 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 is the entry the value-added server makes in SYS:SYSTEM\NET$ACCT.DAT.

NCP Calls

See Also

NWSubmitAccountHold, NWSubmitAccountNote