共用方式為


ConvertInterfaceLuidToGuid 函式

ConvertInterfaceLuidToGuid函式會將網路介面的本機唯一識別碼 (LUID) 轉換為介面的全域唯一識別碼 (GUID) 。

注意

ConvertInterfaceXxx API 系列會列舉系結至 TCP/IP 之所有介面的識別碼,其中包括虛擬迷你埠、輕量型篩選、通道配接器和實體介面。

語法

NETIOAPI_API ConvertInterfaceLuidToGuid(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       GUID     *InterfaceGuid
);

參數

  • InterfaceLuid [in]
    網路介面 NET_LUID 聯集的指標。

  • InterfaceGuid [out]
    網路介面之 GUID 的指標。

傳回值

ConvertInterfaceLuidToGuid 如果函式成功,則會傳回STATUS_SUCCESS。 如果函式失敗, InterfaceGuid 參數會設定為 NullConvertInterfaceLuidToGuid 會傳回下列錯誤碼:

傳回碼 描述
STATUS_INVALID_PARAMETER

其中一個參數無效。 ConvertInterfaceLuidToGuid 如果 InterfaceLuidInterfaceGuidNull,或者InterfaceLuid無效,則會傳回此錯誤。

備註

ConvertInterfaceLuidToGuid函式與通訊協定無關,可與 IPv6 和 IPv4 通訊協定的網路介面搭配使用。

規格需求

目標平台

普遍

版本

可在 Windows Vista 和更新版本的 Windows 作業系統中使用。

標頭

Netioapi.h (包括 Netioapi.h)

程式庫

Netio.lib

IRQL

PASSIVE_LEVEL

另請參閱

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID