funzione if_nametoindex
La funzione if_nametoindex converte il nome dell'interfaccia ANSI per un'interfaccia di rete nell'indice locale per l'interfaccia.
Sintassi
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
Parametri
-
InterfaceName [in]
Puntatore a una stringa ANSI con terminazione NULL contenente il nome dell'interfaccia.
Valore restituito
Se la funzione ha esito positivo, if_nametoindex restituisce l'indice dell'interfaccia locale. Se la funzione ha esito negativo, if_nametoindex restituisce zero.
Osservazioni
La funzione if_nametoindex esegue il mapping di un nome di interfaccia nell'indice corrispondente. Questa funzione è progettata come parte delle estensioni socket di base per IPv6, come descritto da IETF in RFC 2553.
La funzione if_nametoindex viene implementata per la portabilità dei driver con ambienti Unix, ma le funzioni ConvertInterfaceXxx sono il metodo preferito per convertire gli identificatori dell'interfaccia di rete. È possibile sostituire la funzione if_nametoindex tramite una chiamata alla funzione ConvertInterfaceNameToLuidA per convertire il nome dell'interfaccia ANSI in un'unione NET_LUID, seguita da una chiamata alla funzione ConvertInterfaceLuidToIndex per convertire NET_LUID nell'indice dell'interfaccia locale.
Se la funzione if_nametoindex ha esito negativo e restituisce zero, non è possibile determinare un codice di errore.
Fabbisogno
Piattaforma di destinazione |
universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |