| INT SetRetryCount(
|
| |
INT nRetries |
|
| );
|
The SetRetryCount method sets the number of attempts that
the client will make attempting to resolve a query. When used in
conjunction with the SetTimeout method, it determines the
total amount of time the client will spend attempting to resolve a
query.
Parameters
- nRetries
- The number of attempts the client will make, per nameserver, to
resolve a query.
Return Value
If the method succeeds, the return value is zero. If the method
fails, the return value is DNS_ERROR. To get extended error
information, call GetLastError.
Remarks
The retry count determines the amount of time the client will
wait for a response from each query, the effective amount of time
the client will wait increases with each nameserver and the total
number of retries specified. For example, two nameservers
registered with the client, with a default of 4 retries per
nameserver and a timeout value of 10 seconds, would cause the
client to wait a total of 80 seconds until it returns an error
indicating that it was unable to resolve the query.
Requirements
Client: Requires Windows 7, Windows Vista or Windows
XP.
Server: Requires Windows Server 2008 or Windows Server
2003.
Header: Include cstools7.h.
Library: Use csdnsav7.lib.
Unicode: Implemented as Unicode and ANSI versions.
See Also
GetRetryCount, GetTimeout, SetTimeout
|