Funzione ConvertInterfaceLuidToAlias
La funzione ConvertInterfaceLuidToAlias converte un identificatore univoco locale (LUID) per un'interfaccia di rete in un alias di 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 ConvertInterfaceLuidToAlias(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceAlias,
_In_ SIZE_T Length
);
Parametri
InterfaceLuid [in]
Puntatore a un'unione NET_LUID per l'interfaccia di rete.InterfaceAlias [out]
Puntatore a un buffer per contenere la stringa Unicode con terminazione NULL. Se ConvertInterfaceLuidToAlias restituisce correttamente, InterfaceAlias contiene il nome alias dell'interfaccia di rete.Lunghezza [in]
Lunghezza, in base al numero di caratteri, del buffer a cui punta il parametro InterfaceAlias . Questo valore deve essere sufficientemente grande da contenere il nome alias dell'interfaccia di rete 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
ConvertInterfaceLuidToAlias restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, ConvertInterfaceLuidToAlias restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceLuidToAlias restituisce questo errore se InterfaceLuid o InterfaceAlias è NULL o se InterfaceLuid non è valido. |
| STATUS_NOT_ENOUGH_MEMORY | Spazio di archiviazione insufficiente. ConvertInterfaceLuidToAlias restituisce questo errore se le dimensioni del buffer a cui punta il parametro InterfaceAlias non erano così grandi come specificato nel parametro Length e pertanto il buffer non può contenere il nome dell'alias. |
Commenti
La funzione ConvertInterfaceLuidToAlias è indipendente dal protocollo e funziona con le interfacce di rete per i protocolli IPv6 e IPv4.
La lunghezza massima del nome dell'alias per un'interfaccia di rete, NDIS_IF_MAX_STRING_SIZE, senza il carattere NULL di terminazione, viene dichiarata 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 .
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 |