| 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
Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Import Library: csdnsv11.lib
Unicode: Implemented as Unicode and ANSI versions
See Also
GetRetryCount,
GetTimeout,
SetTimeout
|