Funzione ConvertInterfaceNameToLuidA
La funzione ConvertInterfaceNameToLuidA converte un nome di interfaccia di rete ANSI nell'identificatore univoco locale (LUID) per l'interfaccia.
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 ConvertInterfaceNameToLuidA(
_In_ const CHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parametri
InterfaceName [in]
Puntatore a una stringa ANSI con terminazione NULL contenente il nome dell'interfaccia di rete.InterfaceLuid [out]
Puntatore all'unione NET_LUID per questa interfaccia.
Valore restituito
ConvertInterfaceNameToLuidA restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, ConvertInterfaceNameToLuidA restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| ERROR_BUFFER_OVERFLOW | La lunghezza del nome dell'interfaccia ANSI non è valida. ConvertInterfaceNameToLuidA restituisce questo errore se il parametro InterfaceName supera la lunghezza massima della stringa consentita per questo parametro. |
| STATUS_INVALID_NAME | Il nome dell'interfaccia non è valido. ConvertInterfaceNameToLuidA restituisce questo errore se il parametro InterfaceName contiene un nome di interfaccia non valido. |
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceNameToLuidA restituisce questo errore se il parametro InterfaceLuid è NULL. |
Commenti
La funzione ConvertInterfaceNameToLuidA è indipendente dal protocollo e funziona con interfacce di rete per i protocolli IPv6 e IPv4.
La lunghezza massima del nome dell'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza null di terminazione, viene 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 ConvertInterfaceNameToLuidW per convertire un nome di interfaccia Unicode in un LUID.
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 |