<Return[G]><Top>

gethostbyname

Declare Function Api_gethostbyname& Lib "wsock32" Alias "gethostbyname" (ByVal HostName$)

Declare Function gethostbyname Lib "wsock32" (ByVal HostName As String) As Long

インターネットホスト名に対応するIPアドレスを取得する。

パラメータ
name
    [入力] ホストのNULL終端名へのポインタ。

戻り値
    エラーが発生しなかった場合は、gethostbynameは、上記のhostent構造体へのポインタを返す。それ以外の場合は、nullポインタを返

    し、特定のエラー番号は、WSAGetLastErrorを呼び出すことによって取得することができる。

    エラーコード                          

意味                                                                                                

    WSANOTINITIALISED

成功したWSAStartupを呼び出し、この関数を使用する前に行う必要がある。

    WSAENETDOWN

ネットワークサブシステムに障害が発生した。

    WSAHOST_NOT_FOUND

ホストが見つからなかった。

    WSATRY_AGAIN

権限のないホストが見つからないか、サーバーの障害。

    WSANO_RECOVERY

回復不能なエラーが発生した。

    WSANO_DATA

有効な名前、要求されたタイプのデータレコード。

    WSAEINPROGRESS

ブロッキングWindowsは1.1のコールが進行中であるソケット、またはサービスプロバイダがコールバック関数をまだ処理している。

    WSAEFAULT

nameパラメータは、ユーザアドレス空間の有効な部分ではない。

    WSAEINTR

ブロッキングWindowsソケット1.1コールがWSACancelBlockingCallによってキャンセルされた。