Delen via


De functie ConvertInterfaceLuidToIndex

De functie ConvertInterfaceLuidToIndex converteert een lokaal unieke id (LUID) voor een netwerkinterface naar de lokale index voor de interface.

Notitie

De ConvertInterfaceXxx API-serie inventariseert id's voor alle interfaces die zijn gebonden aan TCP/IP, waaronder virtuele miniports, lichtgewicht filters, tunneladapters en fysieke interfaces.

Syntaxis

NETIOAPI_API ConvertInterfaceLuidToIndex(
  _In_  const NET_LUID     *InterfaceLuid,
  _Out_       PNET_IFINDEX InterfaceIndex
);

Parameters

  • InterfaceLuid [in]
    Een aanwijzer naar een NET_LUID-samenvoeging voor de netwerkinterface.

  • InterfaceIndex [out]
    De lokale indexwaarde voor de netwerkinterface.

Retourwaarde

ConvertInterfaceLuidToIndex retourneert STATUS_SUCCESS als de functie slaagt. Als de functie mislukt, wordt de parameter InterfaceIndex ingesteld op NET_IFINDEX_UNSPECIFIED en retourneert ConvertInterfaceLuidToIndex de volgende foutcode:

Retourcode Beschrijving
STATUS_INVALID_PARAMETER

Een van de parameters is ongeldig. ConvertInterfaceLuidToIndex retourneert deze fout als InterfaceLuid of InterfaceIndexNULL-is of als InterfaceLuid- ongeldig is.

Opmerkingen

De functie ConvertInterfaceLuidToIndex is protocolonafhankelijk en werkt met netwerkinterfaces voor zowel de IPv6- als IPv4-protocollen.

Eisen

Doelplatform

Universal

Versie

Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.

Rubriek

Netioapi.h (inclusief Netioapi.h)

Bibliotheek

Netio.lib

IRQL

PASSIVE_LEVEL

Zie ook

ConvertInterfaceAliasToLuid-

ConvertInterfaceGuidToLuid-

ConvertInterfaceIndexToLuid-

ConvertInterfaceLuidToAlias-

ConvertInterfaceLuidToGuid-

ConvertInterfaceLuidToNameA-

ConvertInterfaceLuidToNameW-

ConvertInterfaceNameToLuidA-

ConvertInterfaceNameToLuidW-

NET_LUID