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 對十六進位數位，以連字元分隔 (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 頭檔中。
注意
ip2string.h 標頭會根據 UNICODE 預處理器常數的定義，將 RtlEthernetAddressToString 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | ip2string.h (包含 Mstcpip.h、Ip2string.h) |
| 程式庫 | ntdll.lib |
| Dll | ntdll.dll |