NWSubmitAccountHold

Reserves a specified amount of an object’s account balance before the object receives and is charged for a service on the network

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 NWSubmitAccountHold ( 
      NWCONN_HANDLE       conn,  
      nuint16             objType,  
      const nstr8 N_FAR  *objName,  
      nint32              holdAmt);

Pascal Syntax

   uses calwin32 
    
   Function NWSubmitAccountHold   
     (conn : NWCONN_HANDLE; 
      objType : nuint16; 
      objName : pnstr8; 
      holdAmt : nint32 
   ) : NWCCODE;

Parameters

conn
(IN) Specifies the NetWare server connection handle.
objType
(IN) Specifies the type of the object for which the hold is desired.
objName
(IN) Points to the name of the object for which the hold is desired (48 character maximum).
holdAmt
(IN) Specifies the amount to be held against the object’s account balance.

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

0x89C3

ERR_TOO_MANY_HOLDS

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

NWSubmitAccountHold reserves a specified amount of an object’s account balance that object receives and is charged for services on the network.

objType and objName must uniquely identify the object and cannot contain wildcard characters.

holdAmt gets the amount the server expects to charge for the service it is about to provide to the object.

NOTE:No more than 16 servers can reserve amounts of an object’s account balance at one time. Multiple holds from the same server are combined.

NCP Calls

See Also

NWQueryAccountingInstalled, NWGetAccountStatus, NWSubmitAccountCharge, NWSubmitAccountNote