RtlEthernetAddressToStringA 関数 (ip2string.h)

RtlEthernetAddressToString 関数は、バイナリ イーサネット アドレスをイーサネット MAC アドレスの文字列形式に変換します。

構文

NTSYSAPI PSTR RtlEthernetAddressToStringA(
  [in]  const DL_EUI48 *Addr,
  [out] PSTR           S
);

パラメーター

[in] Addr

バイナリ形式のイーサネット アドレス。 イーサネット アドレスはネットワーク順 (左から右に並べ替えられたバイト数) です。

[out] S

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

戻り値

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

備考

RtlEthernetAddressToString 関数は、バイナリ イーサネット アドレスをイーサネット EUI-48 データ リンク 層アドレス形式 (一般に MAC アドレスとも呼ばれます) のイーサネット アドレスの文字列形式に変換するために使用されます。 この文字列は、非 DIX 標準の "-'' 表記で表される数値イーサネット アドレスを表します。

S パラメーターで返される文字列は、非 DIX 標準の "-" 表記でイーサネット MAC アドレス文字列の形式で表されます。 イーサネット MAC アドレスの基本的な文字列表現は、ダッシュで区切られた 6 組の 16 進数 (F4-CE-46-2D-90-8C など) で構成されます。

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

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

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

DL_EUI48 データ型は、Mstcpip.h ヘッダー ファイルで定義されます。

手記

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

必要条件

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

関連項目

RtlEthernetStringToAddress の