RtlIpv6AddressToStringA 関数 (ip2string.h)

[アーティクル]
02/01/2024

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

構文

NTSYSAPI PSTR RtlIpv6AddressToStringA(
  [in]  const in6_addr *Addr,
  [out] PSTR           S
);

パラメーター

[in] Addr

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

[out] S

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

戻り値

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

注釈

RtlIpv6AddressToString 関数は、IPv6 アドレスをインターネット標準形式の IPv6 アドレスの文字列表現に変換するために使用されます。

基本的な文字列表現は、コロンで区切られた 8 つの 16 進数で構成されます。連続する 0 個の数値の文字列は、二重コロンに置き換えられます。 IPv6 アドレスの文字列形式では、1 つの double-colon しか使用できません。アドレスが IPv4 互換アドレス、IPv4 マップ IPv6 アドレス、または ISATAP アドレスである場合、最後の 32 ビットは IPv4 スタイルのドットオクテット表記で表されます。詳細については、IETF によって公開された RFC 5942 のセクション 5 を参照してください。

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

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

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

IN6_ADDR構造体は、In6addr.h ヘッダーファイルで定義されています。

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

注意

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

要件


サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	ip2string.h (Mstcpip.h、Ip2string.h を含む)
Library	ntdll.lib
[DLL]	ntdll.dll