if_nametoindex, functie

De functie if_nametoindex converteert de NAAM van de ANSI-interface voor een netwerkinterface naar de lokale index voor de interface.

Syntaxis

NET_IFINDEX NETIOAPI_API_ if_nametoindex(
  _In_ PCSTR InterfaceName
);

Parameters

• InterfaceName [in]
  Een aanwijzer naar een DOOR NULL beëindigde ANSI-tekenreeks die de interfacenaam bevat.

Retourwaarde

Als de functie slaagt, retourneert if_nametoindex de lokale interface-index. Als de functie mislukt, retourneert if_nametoindex nul.

Opmerkingen

De functie if_nametoindex wijst een interfacenaam toe aan de bijbehorende index. Deze functie is ontworpen als onderdeel van basic socket-extensies voor IPv6 zoals beschreven door de IETF in RFC 2553.

De if_nametoindex-functie is geïmplementeerd voor de draagbaarheid van stuurprogramma's met Unix-omgevingen, maar de ConvertInterfaceXxx-functies zijn de voorkeursmethode om netwerkinterface-id's te converteren. U kunt de functie if_nametoindex vervangen door een aanroep naar de functie ConvertInterfaceNameToLuidA om de naam van de ANSI-interface te converteren naar een NET_LUID-samenvoeging, gevolgd door een aanroep naar de functie ConvertInterfaceLuidToIndex om NET_LUID te converteren naar de lokale interfaceindex.

Als de if_nametoindex-functie mislukt en nul retourneert, kunt u geen foutcode bepalen.

Eisen

Zie ook

ConvertInterfaceLuidToIndex

ConvertInterfaceNameToLuidA-

NET_LUID