NWSubmitAccountHold(3nw)


NWSubmitAccountHold -- reserves part of an object's account balance

Synopsis

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

NWCCODE N_API NWSubmitAccountHold (NWCONN_HANDLE conn, nuint16 objType, pnstr8 objName, nint32 holdAmt);

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 the name of the object for which the status is desired (48 character maximum).

holdAmt
(IN) Specifies the amount to be held against the object's account balance.

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

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

Notices

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.

Services

Accounting

NCP calls

0x2222 23 152 Submit Account Hold

 
 0x2222   23   152   Submit Account Hold 

References

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