目次 - 3.関数 - 3.2名前解決 - SDLNet_ResolveHost

SDLNet_ResolveHost

int SDLNet_ResolveHost(IPaddress *address, const char *host, Uint16 port)

address
アドレスが代入されるポインタ. 呼ばれる前は何も設定されていなくてよいが, メモリが確保されている必要がある
host
サーバに接続するためのホスト名またはIPアドレスの文字列. サーバになる場合はNULL. NULLのとき, 全てのネットワークインターフェースは接続のためにINADDR_ANYを使ってLISTEN状態になる
port
サーバに接続する場合はサーバがLISTENしているポート番号. サーバになる場合はLISTENするポート番号. この関数を単なるドメイン名解決として使う場合は0にできる

文字列hostを解決し, 解決されたIPとポート番号portをIPaddress構造体のポインタに代入する. これがIPaddress構造体を設定する最もよい方法である. この関数はあらゆるソケットを実際に開くことはない. ソケットを開く関数の引数の準備のために使われる.

注意: この関数はhostとportをaddressのフィールドにネットワークバイト順で書き込む. 引数はシステムのバイト順で渡さなければならない. (これが問題になることはあまりない.)

戻り値; 成功のとき0, アドレスが解決できないなど失敗のとき-1で, address.hostにINADDR_NONEが代入される.

参照

SDLNet_ResolveIP, IPaddress

原文へのリンク

3.2.1 SDLNet_ResolveHost