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:
-
the object ID of the server placing the hold
-
the amount of the server's hold
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.