Funzione ConvertInterfaceLuidToNameA
La funzione ConvertInterfaceLuidToNameA converte un identificatore univoco locale (LUID) per un'interfaccia di rete nel nome dell'interfaccia ANSI.
Nota
La famiglia di API ConvertInterfaceXxx enumera gli identificatori su tutte le interfacce associate a TCP/IP, che possono includere miniport virtuali, filtri leggeri, schede di tunnel e interfacce fisiche.
Sintassi
NETIOAPI_API ConvertInterfaceLuidToNameA(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PSTR InterfaceName,
_In_ SIZE_T Length
);
Parametri
InterfaceLuid [in]
Puntatore a un'unione NET_LUID per un'interfaccia di rete.InterfaceName [out]
Puntatore a un buffer per contenere la stringa ANSI con terminazione NULL. Se ConvertInterfaceLuidToNameA restituisce correttamente, InterfaceName contiene il nome dell'interfaccia ANSI.Lunghezza [in]
Lunghezza, in byte, del buffer a cui punta il parametro InterfaceName . Questo valore deve essere sufficientemente grande da contenere il nome dell'interfaccia e il carattere NULL di terminazione. La lunghezza massima consentita è NDIS_IF_MAX_STRING_SIZE + 1. Per altre informazioni su NDIS_IF_MAX_STRING_SIZE, vedere la sezione Osservazioni seguente.
Valore restituito
ConvertInterfaceLuidToNameA restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, ConvertInterfaceLuidToNameA restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceLuidToNameA restituisce questo errore se InterfaceLuid o InterfaceName è NULL o se InterfaceLuid non è valido. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameA restituisce questo errore se il buffer InterfaceName non è grande quanto specificato nel parametro Length e, pertanto, il buffer non può contenere il nome dell'interfaccia. |
Commenti
La funzione ConvertInterfaceLuidToNameA è indipendente dal protocollo e funziona con le interfacce di rete per i protocolli IPv6 e IPv4.
La lunghezza massima del nome per un'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza il carattere NULL di terminazione, è definita nel file di intestazione Ntddndis.h. NDIS_IF_MAX_STRING_SIZE è 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 .
Utilizzare la funzione ConvertInterfaceLuidToNameW per convertire un LUID dell'interfaccia di rete in un nome di interfaccia Unicode.
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 |