次の方法で共有


RtlIpv6AddressToStringA 関数 (ip2string.h)

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 つのダブルコロンしか存在できません。 アドレスが IPv4 互換アドレス、IPv4 マップ IPv6 アドレス、または ISATAP アドレスである場合、最後の 32 ビットは IPv4 スタイルのドットオクテット表記で表されます。 詳細については、IETF によって公開 RFC 5942 のセクション 5 を参照してください。

RtlIpv6AddressToString は、WINDOWS ソケットで提供される関数にアクセスして、IP アドレスから文字列への変換を実行するために 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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RtlIpv6AddressToString を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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

関連項目

GetModuleHandle を する

GetProcAddress の

InetNtop を する

InetPton

LoadLibrary

RtlIpv4AddressToString を する

RtlIpv4AddressToStringEx の

RtlIpv4StringToAddress の

RtlIpv4StringToAddressEx の

RtlIpv6AddressToStringEx を する

RtlIpv6StringToAddress の

RtlIpv6StringToAddressEx の

inet_addr

inet_ntoa