| INT SetTimeout(
|
| |
INT nTimeout |
|
| );
|
The SetTimeout method sets the number of seconds that the
client will wait for a response from a nameserver. The timeout
value is used each time a server in the client's nameserver table
is queried. When used in conjunction with the SetRetryCount
method, it determines the total amount of time the client will
spend attempting to resolve a query.
Parameters
- nTimeout
- The number of seconds until the client times out waiting for a
response from a nameserver.
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 timeout value 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, with 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, SetRetryCount
|