funzione if_indextoname (netioapi.h)
La funzione if_indextoname converte l'indice locale per un'interfaccia di rete nel nome dell'interfaccia ANSI.
Sintassi
IPHLPAPI_DLL_LINKAGE PCHAR NETIOAPI_API_ if_indextoname(
[in] NET_IFINDEX InterfaceIndex,
[out] PCHAR InterfaceName
);
Parametri
[in] InterfaceIndex
Indice locale per un'interfaccia di rete.
[out] InterfaceName
Puntatore a un buffer per contenere la stringa ANSI con terminazione NULL contenente il nome dell'interfaccia quando la funzione viene restituita correttamente. La lunghezza, in byte, del buffer a cui punta questo parametro deve essere uguale o maggiore di IF_NAMESIZE.
Valore restituito
In caso di esito positivo, if_indextoname restituisce un puntatore alla stringa ANSI con terminazione NULL contenente il nome dell'interfaccia. In caso di errore, viene restituito un puntatore NULL .
Commenti
La funzione if_indextoname è disponibile in Windows Vista e versioni successive.
La funzione if_indextoname esegue il mapping di un indice di interfaccia al nome corrispondente. Questa funzione è progettata come parte delle estensioni socket di base per IPv6, come descritto da IETF in RFC 2553. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc2553.txt.
La funzione if_indextoname viene implementata per la portabilità delle applicazioni con ambienti Unix, ma sono preferibili le funzioni ConvertInterface. La funzione if_indextoname può essere sostituita da una chiamata alla funzione ConvertInterfaceIndexToLuid per convertire un indice di interfaccia in un NET_LUID seguito da una chiamata a ConvertInterfaceLuidToNameA per convertire il NET_LUID nel nome dell'interfaccia ANSI.
Se il if_indextoname ha esito negativo e restituisce un puntatore NULL , non è possibile determinare un codice di errore.
La lunghezza, in byte, del buffer a cui punta il parametro InterfaceName deve essere uguale o maggiore di IF_NAMESIZE, un valore dichiarato nel file di intestazione Netioapi.h uguale a NDIS_IF_MAX_STRING_SIZE. La lunghezza massima di un nome di interfaccia, NDIS_IF_MAX_STRING_SIZE, senza che il valore NULL di terminazione venga dichiarato nel file di intestazione Ntddndis.h . Il NDIS_IF_MAX_STRING_SIZE viene definito come costante IF_MAX_STRING_SIZE definita nel file di intestazione Ifdef.h . I file di intestazione Ntddndis.h e Ifdef.h vengono inclusi automaticamente nel file di intestazione Netioapi.h , incluso automaticamente dal file di intestazione Iphlpapi.h . I file di intestazione Ntddndis.h, Ifdef.h e Netioapi.h non devono mai essere usati direttamente.
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 (include Iphlpapi.h) |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll |