DWC_TestInetAsync

構文

#include <dwc.h>
BOOL DWC_TestInetAsync(int timeout);

引数

timeout 接続テストのタイムアウト時間[msec]
0以下を指定した場合に適用されるデフォルトのタイムアウト時間は、3000msecです。
タイムアウト時間が短すぎると正常にテストできません。

返り値

TRUE 接続テストを開始した
FALSE 接続テストの開始に失敗した。
具体的には下記条件になります。
  • ライブラリ内部で動的に確保するためのメモリが不足している
  • 既に接続テストを実行中
  • DWC_ConnectInetAsync関数でインターネットに接続してからDWC_CleanupInet関数かDWC_CleanupInetAsync関数で切断するまでの間でない

説明

接続テスト用サーバと通信することによるインターネットとの接続テストを開始します。

Proxy設定がされた接続先に接続した場合、本関数は1回目の呼び出しの時、接続先ドメインの解決のため長時間ブロックする可能性がありますので注意して下さい。
2回目以降は、staticな領域に保存されたIPアドレスを使用しますので長時間ブロックすることはありません。

本関数を呼び出した後は、接続テストの通信処理を実行するために処理が終わるまでDWC_TestInetProcess関数を毎ゲームフレーム程度の頻度で呼び出してください。
接続テストの処理中に本関数を呼び出した場合は必ずFALSEを返します。

本関数によって接続テストが開始された時点で必要なメモリが確保されるため、接続テストの通信処理が終わって自動的にメモリが解放されるまで処理を続けてください。

接続テスト用サーバと通信を行いますので、短い間隔で繰り返し呼び出さないでください。
アクセスポイントとの接続状態を確認するDWC_UpdateConnection関数も参照してください。

参照

DWC_TestInetProcess DWC_UpdateConnection DWC_ConnectInetAsync DWC_CleanupInet DWC_CleanupInetAsync

履歴

5.1pr2より前の変更履歴はこちら