gethostent() - 次のホスト・エントリーの取得

標準

標準/拡張機能	C/C++	依存項目
XPG4.2 Single UNIX Specification、バージョン 3	両方

X/Open:

#define _XOPEN_SOURCE_EXTENDED 1
#include <netdb.h>

struct hostent *gethostent(void);

バークレー・ソケット:

#define _OE_SOCKETS
#include <netdb.h>

struct hostent *gethostent(void);

gethostent() 呼び出しは、ローカル・ホスト・テーブルの次の行を読み取ります。

gethostent() 呼び出しは、ローカル・ホスト・テーブルで次のエントリーを指すポインターを戻します。gethostent() は、別名を得るために、ローカル・ホスト・テーブルを使用します。

X_SITE 環境を使用して、さまざまなローカル・ホスト・テーブルを指定し、初期化中に z/OS リゾルバーが提供したローカル・ホスト・テーブルをオーバーライドすることができます。

注: これらのローカル・ホスト・テーブルまたは環境変数について詳しくは、「z/OS V2R2.0 Communications Server: IP 構成ガイド) を参照してください。

gethostent()、gethostbyaddr()、および gethostbyname() は、いずれも同じ静的領域を使用して hostent 構造体を戻します。この静的領域は、これらの次の関数が同じスレッドで呼び出されるまで有効です。

netdb.h 組み込みファイルは、hostent 構造体を定義し、以下のエレメントを含みます。

C++ の特殊な動作: C++ でこの関数を使用するには、_XOPEN_SOURCE_EXTENDED 1 フィーチャー・テスト・マクロを使用する必要があります。

正常に実行された場合、gethostent() は hostent 構造体へのポインターを戻します。戻り値は、同じデータ構造体を戻す、以降の呼び出しで上書きされるデータを指します。

正常に終了しなかった場合は、gethostent() は NULL ポインターを戻し、エラーまたはファイル終わり (EOF)を示します。