| 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
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
See Also
GetRetryCount,
GetTimeout,
SetRetryCount
|