目次 - SDL_net 3.0 - NET_GetAddressStatus

NET_GetAddressStatus

ブロックせずにアドレスが解決したかチェックする

ヘッダ

NET_Status NET_GetAddressStatus(NET_Address *address);

address

問い合わせるNET_Addressオブジェクト

(NET_Status) 解決に成功したときNET_SUCCESS, 解決に失敗したときNET_FAILURE, 解決中のときNET_WAITING(解決が完了する前にタイムアウトした)を戻す. NET_FAILUREの場合, SDL_GetError()を呼んで詳細を知ることができる.

NET_ResolveHostnameが戻したNET_Addressオブジェクトの解決には時間がかかるため, 処理はアプリケーションがどれだけかかるかわからない時間を待つのではなく非同期に行われる.

この関数はブロックせずに処理の状態をチェックできる.

時間がかかった後で解決が失敗することもあるため(ホスト名が解決しなかったことをDNSサーバが応答するまで時間がかかった等), 成功したとみなさずに必ず結果をチェックすること.

解決に成功した後は, このアドレスのホストに接続するために使用できる.

この関数はどのスレッドからも安全に呼べる.

SDL_net 3.0.0以降