ConvertInterfaceLuidToIndex függvény

A ConvertInterfaceLuidToIndex függvény helyileg egyedi azonosítót (LUID) alakít át egy hálózati adapterhez a felület helyi indexére.

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 ConvertInterfaceLuidToIndex(
  _In_  const NET_LUID     *InterfaceLuid,
  _Out_       PNET_IFINDEX InterfaceIndex
);

Paraméterek

  • InterfaceLuid [in]
    Egy NET_LUID egyesítésre mutató mutató a hálózati adapterhez.

  • InterfaceIndex [ki]
    A hálózati adapter helyi indexértéke.

Visszaadott érték

ConvertInterfaceLuidToIndex STATUS_SUCCESS ad vissza, ha a függvény sikeres. Ha a függvény sikertelen, a InterfaceIndex paraméter értéke NET_IFINDEX_UNSPECIFIED, és ConvertInterfaceLuidToIndex a következő hibakódot adja vissza:

Kód visszaadása Leírás
STATUS_INVALID_PARAMETER

Az egyik paraméter érvénytelen. ConvertInterfaceLuidToIndex akkor adja vissza ezt a hibát, ha InterfaceLuid vagy InterfaceIndexNULL, vagy ha InterfaceLuid érvénytelen.

Megjegyzések

A ConvertInterfaceLuidToIndex 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

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID