Syntax

   #include <nwacct.h> 
   or 
   #include <nwcalls.h> 
    
   NWCCODE N_API NWGetAccountStatus ( 
      NWCONN_HANDLE         conn,  
      nuint16               objType,  
      const nstr8 N_FAR    *objName,  
      pnint32               balance,  
      pnint32               limit,  
      HOLDS_STATUS N_FAR   *holds); 
   
   

Pascal Syntax

   uses calwin32 
    
   Function NWGetAccountStatus   
     (conn : NWCONN_HANDLE; 
      objType : nuint16; 
      const objName : pnstr8; 
      balance : pnint32; 
      limit : pnint32; 
      Var holds : HOLDS_STATUS 
   ) : NWCCODE; 
   
   

Parameters

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 or will be truncated.)

balance

(OUT) Points to the amount of value units available to the object to buy services on the network (optional, pass in NULL).

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, pass in NULL).

holds

(OUT) Points to HOLDS_STATUS containing a list of objects placing a hold on the object’s account (optional, pass in NULL).

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

Remarks

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: (1) the object ID of the server placing the hold, and (2) the amount of the server’s hold.

The ACCOUNT_SERVERS property on the server must contain the object ID of the requesting server. Otherwise, NWSubmitAccountHold will return NO_ACCOUNTING_PRIVILEGES. The user must have an ACCOUNT_BALANCE property on the NetWare server or NWSubmitAccountHold will return LOGIN_DENIED_NO_ACCOUNT_BALANCE.

NCP Calls

• 0x2222 23 150 Get Current Account Status

See Also

NWQueryAccountingInstalled, NWSubmitAccountCharge, NWSubmitAccountHold, NWSubmitAccountNote