Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> usraccountreserveget()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 UsrAccountReserveGet()
------------------------------------------------------------------------------
 Purpose:
 Get a user's account reserve balance.

 Syntax:
 lResult = UsrAccountReserveGet( lpszUserName, lpszServer )

 Parameters:
 lpszUserName The name of the user.
 lpszServer   The name of the account server.

 Returns:
 A numeric value (signed long int).

 The CA-Clipper name for this function is:
 UsrAccResGet()

 Description:
 UsrAccountReserveGet() returns the amount that a specified account
 server lpszServer has reserved from the balance of the user lpszUserName.

 An account server places a hold on a specified amount before it gives
 service to ensure that the user has a sufficient balance for the service.
 It also takes into account any other reservations (holds) that may have
 been placed by other servers before giving service.

 Returns a numeric value if successful or NOVERRLONG if an error occurs.

 Example:
 // To return the balance amount the current server is holding
 // against user ISABEL:
 lAccRes = UsrAccountReserveGet( "ISABEL", FSNameGet() )
 if ( !NWErrorGet() )
    ? "User ISABEL has", lAccRes, "reserved by server: ", FSNameGet()
 endif

 Notes:
 UsrAccountReserveGet() checks the server's ACCOUNT_HOLDS property.

See Also: UsrAccountBalanceGet() / UsrAccountBalanceSet() UsrAccountLimitGet() / UsrAccountLimitSet() UsrAccountReserveSet()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson