NWSubmitAccountCharge(3nw)

NWSubmitAccountCharge -- charges amount against object's balance

Synopsis

#include <nwacct.h> or #include <nwcalls.h>

NWCCODE N_API NWSubmitAccountCharge (NWCONN_HANDLE conn, nuint16 objType, pnstr8 objName, nuint16 serviceType, nint32 chargeAmt, nint32 holdCancelAmt, nuint16 noteType, pnstr8 note);

Description

The parameters are as follows:

conn: (IN) Specifies the NetWare server connection handle.
objType: (IN) Specifies the type of the object to charge.
objName: (IN) Points to a string containing the name of the object whose account is to be accessed (48 character maximum).
serviceType: (IN) Specifies the type of service for which the request is being made.
chargeAmt: (IN) Specifies the amount to be charged to the object account balance.
holdCancelAmt: (IN) Specifies the hold amount.
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).

Return values

0x0000: SUCCESSFUL
0x8801: INVALID_CONNECTION
0x8901: ERR_INSUFFICIENT_SPACE
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

Notices

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

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

 
 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:

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

Note types greater than 8000H are reserved.

NOTE: note is the entry the value-added server makes in SYS:SYSTEM\NET$ACCT.DAT.

Services

Accounting

NCP calls

0x2222 23 151 Submit Account Charge

 
 0x2222   23   151   Submit Account Charge

References

NWSubmitAccountHold(3nw), NWSubmitAccountNote(3nw)