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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

RtlEthernetStringToAddress