RtlEthernetAddressToStringW 函式 （ip2string.h）

RtlEthernetAddressToString 函式會將二進位乙太網路位址轉換為乙太網路 MAC 位址的字串表示。

語法

NTSYSAPI PWSTR RtlEthernetAddressToStringW(
  [in]  const DL_EUI48 *Addr,
  [out] PWSTR          S
);

參數

[in] Addr

以二進位格式的乙太網路位址。 乙太網路位址是網路順序（從左至右排序的位元組）。

[out] S

緩衝區的指標，用來儲存 NULL乙太網路地址的終止字串表示。 此緩衝區的大小應該足以容納至少 18 個字元。

傳回值

插入乙太網路 MAC 位址字串表示的 NULL 字元指標。 呼叫端可以使用此選項，輕鬆地將更多資訊附加至字串。

言論

RtlEthernetAddressToString 函式可用來將二進位乙太網路位址轉換成乙太網路位址的字串表示法，以乙太網路 EUI-48 數據連結層位址格式（也稱為 MAC 位址）。 字串代表以非 DIX 標準 “-'' 表示法表示的數值乙太網络位址。

在 S 參數中傳回的字串會以非 DIX 標準 “-” 表示法中以乙太網路 MAC 位址字串的形式表示。 乙太網路 MAC 位址的基本字串表示是由 6 對十六進位數位組成，並以破折號分隔（例如 F4-CE-46-2D-90-8C）。

RtlEthernetAddressToString 是一種便利函式，不需要載入 Windows Sockets DLL 以存取 Windows Sockets 中提供的函式，以執行字串到乙太網路位址轉換。

定義 UNICODE 或_UNICODE時，RtlEthernetAddressToString 定義為 RtlEthernetAddressToStringW，此函式的 Unicode 版本。 字串參數 S 和函式傳回值會定義至 PWSTR 資料類型。

未定義 UNICODE 和_UNICODE時，RtlEthernetAddressToString 會定義為 RtlEthernetAddressToStringA，此函式的 ANSI 版本。 字串參數 S 和函式傳回值會定義至 PSTR 資料類型。

DL_EUI48 數據類型定義於 Mstcpip.h 頭檔中。

要求

另請參閱

RtlEthernetStringToAddress