Funzione if_nametoindex (netioapi.h)
La funzione if_nametoindex converte il nome dell'interfaccia ANSI per un'interfaccia di rete nell'indice locale per l'interfaccia.
Sintassi
IPHLPAPI_DLL_LINKAGE NET_IFINDEX NETIOAPI_API_ if_nametoindex(
[in] PCSTR InterfaceName
);
Parametri
[in] InterfaceName
Puntatore a una stringa ANSI con terminazione NULL contenente il nome dell'interfaccia.
Valore restituito
In caso di esito positivo, if_nametoindex restituisce l'indice dell'interfaccia locale. In caso di errore, viene restituito zero.
Commenti
La funzione if_nametoindex è disponibile in Windows Vista e versioni successive.
La funzione if_nametoindex esegue il mapping di un nome dell'interfaccia nell'indice corrispondente. Questa funzione è progettata come parte delle estensioni di socket di base per IPv6, come descritto dall'IETF in RFC 2553. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc2553.txt.
La funzione if_nametoindex viene implementata per la portabilità delle applicazioni con ambienti Unix, ma le funzioni ConvertInterface sono preferite. La funzione if_nametoindex può essere sostituita da una chiamata alla funzione ConvertInterfaceNameToLuidA per convertire il nome dell'interfaccia ANSI in un NET_LUID seguito da una chiamata a ConvertInterfaceLuidToIndex per convertire il 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | netioapi.h (includere Iphlpapi.h) |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll |