ConvertInterfaceGuidToLuid függvény

A ConvertInterfaceGuidToLuid függvény globálisan egyedi azonosítót (GUID) alakít át egy hálózati adapterhez a felület helyileg egyedi azonosítójához (LUID).

Jegyzet

A ConvertInterfaceXxx API-család számba adja a TCP/IP-hez kötött összes adapter azonosítóit, amelyek virtuális miniportokat, egyszerűsített szűrőket, alagútadaptereket és fizikai adaptereket tartalmazhatnak.

Szintaxis

NETIOAPI_API ConvertInterfaceGuidToLuid(
  _In_  const GUID      *InterfaceGuid,
  _Out_       PNET_LUID InterfaceLuid
);

Paraméterek

• InterfaceGuid [in]
  A hálózati adapter GUID azonosítójának mutatója.

• InterfaceLuid [ki]
  A hálózati adapter NET_LUID egyesítésére mutató mutató.

Visszaadott érték

ConvertInterfaceGuidToLuid a függvény sikeres működése esetén STATUS_SUCCESS ad vissza. Ha a függvény meghiúsul, a InterfaceLuid paraméter értéke null , és ConvertInterfaceGuidToLuid a következő hibakódot adja vissza:

Kód visszaadása	Leírás
STATUS_INVALID_PARAMETER	Az egyik paraméter érvénytelen volt. ConvertInterfaceGuidToLuid akkor adja vissza ezt a hibát, ha InterfaceAlias vagy InterfaceLuidNULL, vagy ha InterfaceGuid érvénytelen.

Megjegyzések

A ConvertInterfaceGuidToLuid függvény protokollfüggetlen, és az IPv6 és az IPv4 protokollok hálózati adaptereivel is működik.

Követelmények

Célplatform	Univerzális
Verzió	Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban.
Fejléc	Netioapi.h (netioapi.h)
Könyvtár	Netio.lib
IRQL	PASSIVE_LEVEL

Lásd még:

ConvertInterfaceAliasToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID