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
|
References
NWQueryAccountingInstalled(3nw),
NWGetAccountStatus(3nw),
NWSubmitAccountCharge(3nw),
NWSubmitAccountNote(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.