Syntax

   #include <\nlm\nit\nwaccntg.h>  
    
   int SubmitAccountHold (  
      WORD    binderyObjectType,  
      char   *binderyObjectName,  
      long    reserveAmount); 
   
   

Parameters

binderyObjectType

(IN) Specifies the type of bindery object whose account balance is to be partially reserved (see Object Type for specific object types).

binderyObjectName

(IN) Specifies the string containing the name of the bindery object whose account balance is to be partially reserved (maximum 48 characters, including the NULL terminator).

reserveAmount

(IN) Specifies the hold amount to be placed against the client’s account pending service.

Return Values

Remarks

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

The binderyObjectType and binderyObjectName parameters must uniquely identify the bindery object and must not contain wildcard characters. The binderyObjectName parameter is a NULL-terminated string (maximum 48 characters, including the NULL terminator). Only printable characters can be used. Slashes, backslashes, colons, semicolons, commas, asterisks, spaces, and question marks are prohibited.

The reserveAmount parameter gets the amount that the server expects to charge for the service it is about to provide to the object. 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.