RtlIpv4AddressToStringA 関数 (ip2string.h)

[アーティクル]
11/20/2024

RtlIpv4AddressToString 関数は、IPv4 アドレスをインターネット標準のドット 10 進数形式の文字列に変換します。

構文

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

パラメーター

[in] Addr

ネットワークバイト順の IPv4 アドレス。

[out] S

NULLIPv4 アドレスの終端文字列表現を格納するバッファーへのポインター。このバッファーは、少なくとも 16 文字を保持するのに十分な大きさにする必要があります。

戻り値

IPv4 アドレスの文字列表現の末尾に挿入される NULL 文字へのポインター。これは、呼び出し元が文字列にさらに多くの情報を簡単に追加するために使用できます。

備考

RtlIpv4AddressToString 関数は、IPv4 アドレスをインターネットドット 10 進数形式の IPv4 アドレスの文字列形式に変換するために使用されます。

RtlIpv4AddressToString は、WINDOWS ソケットで提供される関数にアクセスして、IP アドレスから文字列への変換を実行するために Windows ソケット DLL を読み込む必要がない便利な関数です。

UNICODE または_UNICODEが定義されている場合、RtlIpv4AddressToString は、この関数の Unicode バージョンである RtlIpv4AddressToStringWをするように定義されます。 S 文字列パラメーターと関数の戻り値は、PWSTR データ型に定義されます。

UNICODE と_UNICODEの両方が定義されていない場合、RtlIpv4AddressToString は、この関数の ANSI バージョンである RtlIpv4AddressToStringAをするように定義されます。 S 文字列パラメーターと関数の戻り値は、PSTR データ型に定義されます。

IN_ADDR 構造体は、Inaddr.h ヘッダーファイルで定義されます。

RtlIpv4AddressToString 関数を含むインポートライブラリは、Windows Vista 用にリリースされた Microsoft Windows ソフトウェア開発キット (SDK) には含まれていません。 RtlIpv4AddressToString 関数は、Windows Driver Kit (WDK) に含まれる Ntdll.lib インポートライブラリに含まれています。アプリケーションでは、GetModuleHandle を使用し、GetProcAddress 関数をして、Ntdll.dll から関数ポインターを取得し、この関数を呼び出すこともできます。

手記

ip2string.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RtlIpv4AddressToString を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップアプリ \|UWP アプリ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップアプリ \|UWP アプリ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ip2string.h (Mstcpip.h、Ip2string.h を含む)
ライブラリ	ntdll.lib
DLL	ntdll.dll

次の方法で共有

RtlIpv4AddressToStringA 関数 (ip2string.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース