Funzione ConvertInterfaceAliasToLuid
La funzione ConvertInterfaceAliasToLuid converte un nome alias di interfaccia per un'interfaccia di rete 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 ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
Parametri
InterfaceAlias [in]
Puntatore a una stringa Unicode con terminazione NULL contenente il nome alias dell'interfaccia di rete.InterfaceLuid [out]
Puntatore all'unione NET_LUID per l'interfaccia di rete.
Valore restituito
ConvertInterfaceAliasToLuid restituisce STATUS_SUCCESS se la funzione ha esito positivo. Se la funzione ha esito negativo, il parametro InterfaceLuid è impostato su NULL e ConvertInterfaceAliasToLuid restituisce il codice di errore seguente:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno dei parametri non è valido. ConvertInterfaceAliasToLuid restituisce questo errore se InterfaceAlias o InterfaceLuid è NULL o se InterfaceAlias non è valido. |
Commenti
La funzione ConvertInterfaceAliasToLuid è indipendente dal protocollo e funziona con interfacce di rete per i protocolli IPv6 e IPv4.
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 |