Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 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 non riesce, 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 consentita della stringa 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. |
Osservazioni
La funzione ConvertInterfaceNameToLuidA è indipendente dal protocollo e funziona con le interfacce di rete per i protocolli IPv6 e IPv4.
La lunghezza massima del nome dell'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza la terminazione NULL, è definita nel file di intestazione Ntddndis.h. NDIS_IF_MAX_STRING_SIZE è definita 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 funzioneConvertInterfaceNameToLuidWper convertire un nome di interfaccia Unicode in un LUID.
Fabbisogno
Piattaforma di destinazione |
universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |