DWC_TestInetAsync

C Specification

#include <dwc.h>

BOOL DWC_TestInetAsync( int timeout );

Description

Starts an Internet connection test by communicating with the server for the connection test.

After calling this function, call the DWC_TestInetProcess function every game frame until the process executing the connection test communication process terminates.
Always returns FALSE if this function is called during the connection test process.

Because the memory required at the point the connection test is started is secured by this function, be sure to continue processing until the connection test communication process terminates and memory is automatically freed.

Do not call this function repeatedly over a short period of time as it performs communications with the connection test server.
See also the DWC_UpdateConnection function for checking the connection status with an access point.

Arguments

timeout Timeout interval (in msec) of the connection test.
The default timeout interval of 3000 msec is applied when a value equal to or less than 0 is specified.
The test cannot be conducted normally if the timeout interval is too short.

Return Values

TRUE Connection test started
FALSE Failed to start connection test

See Also

DWC_TestInetProcess, DWC_UpdateConnection

Revision History

2006/11/07 Initial version.


CONFIDENTIAL