NWGetAccountStatus(3nw)


NWGetAccountStatus -- returns account status of server Bindery or Directory Services object

Synopsis

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

NWCCODE N_API NWGetAccountStatus (NWCONN_HANDLE conn, nuint16 objType, pnstr8 objName, pnint32 balance, pnint32 limit, NWHOLDS_STATUS N_FAR * holds);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

objType
(IN) Specifies the type of the object for which the status is desired.

objName
(IN) Points to a string containing the name of the object for which the accounting status is desired (48 characters maximum).

balance
(OUT) Points to the amount of value units available to the object to buy services on the network.

limit
(OUT) Points to the lowest level the object's account balance can reach before the object can no longer buy services on the network (optional).

holds
(OUT) Points to HOLDS_STATUS containing a list of objects placing a hold on the object's account (optional; pass in NULL if the parameter does not need to be returned).

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8996
SERVER_OUT_OF_MEMORY

0x89C0
NO_ACCOUNTING_PRIVILEGES

0x89C1
LOGIN_DENIED_NO_ACCOUNT_BALANCE

0x89C4
ACCOUNTING_DISABLED

0x89E8
NOT_ITEM_PROPERTY

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

NWGetAccountStatus queries a NetWare server's Bindery or Directory bindery context for the current account status of a specified object by passing the object name and type. NWGetAccountStatus returns the object's balance, limit and holds.

balance contains the object's account balance, usually in some established monetary unit such as cents.

holds lists servers calling NWSubmitAccountHold against the object and the amount reserved by each value-added server. holds also lists the object ID number of a value-added server calling NWSubmitAccountHold against the object. Up to 16 servers can place holds on the account at one time. Multiple holds from the same server are combined. Each server hold is made up of two fields:

ACCOUNT_SERVERS must contain the object ID of the requesting server; the user must be a member of ACCOUNT_SERVERS SET on the NetWare server.

Services

Accounting

NCP calls

0x2222 23 150
Get Current Account Status

References

NWQueryAccountingInstalled(3nw), NWSubmitAccountCharge(3nw), NWSubmitAccountHold(3nw), NWSubmitAccountNote(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.