funzione if_indextoname
La funzione if_indextoname converte l'indice locale per un'interfaccia di rete nel nome dell'interfaccia ANSI.
Sintassi
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parametri
InterfaceIndex [in]
Indice locale per un'interfaccia di rete.InterfaceName [out]
Puntatore a un buffer per contenere la stringa ANSI con terminazione NULL. Se if_indextoname ha esito positivo, InterfaceName contiene il nome dell'interfaccia ANSI. Lunghezza, in byte, del buffer a cui punta questo parametro deve essere uguale o maggiore di IF_NAMESIZE. Per altre informazioni su IF_NAMESIZE, vedere la sezione Osservazioni seguente.
Valore restituito
Se questa funzione ha esito positivo, if_indextoname restituisce un puntatore a una stringa ANSI con terminazione NULL contenente il nome dell'interfaccia. Se questa funzione ha esito negativo, if_indextoname restituisce un puntatore NULL
Commenti
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.
La funzione if_indextoname viene implementata per la portabilità dei driver con ambienti Unix, ma le funzioni ConvertInterfaceXxx sono il metodo preferito per convertire gli identificatori di interfaccia di rete. È possibile sostituire la funzione if_indextoname tramite una chiamata alla funzione ConvertInterfaceIndexToLuid per convertire un indice di interfaccia in un'unione NET_LUID , seguita da una chiamata alla funzione ConvertInterfaceLuidToNameA per convertire NET_LUID nel nome dell'interfaccia ANSI.
Lunghezza, in byte, del buffer a cui punta il parametro InterfaceName deve essere uguale o maggiore di IF_NAMESIZE. Il valore IF_NAMESIZE viene definito nel file di intestazione Netioapi.h come uguale a NDIS_IF_MAX_STRING_SIZE. La lunghezza massima di un nome di interfaccia, NDIS_IF_MAX_STRING_SIZE, senza il carattere NULL di terminazione viene dichiarata 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.
Nota
I file di intestazione Ntddndis.h e Ifdef.h vengono inclusi automaticamente nel file di intestazione Netioapi.h . Non usare mai direttamente i file di intestazione Ntddndis.h e Ifdef.h .
Se la funzione if_indextoname ha esito negativo e restituisce un puntatore NULL , non è possibile determinare un codice di errore.
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
PASSIVE_LEVEL |