Función ConvertInterfaceAliasToLuid
La función ConvertInterfaceAliasToLuid convierte un nombre de alias de interfaz para una interfaz de red en el identificador único local (LUID) de la interfaz.
Nota
La familia de API ConvertInterfaceXxx enumera los identificadores de todas las interfaces enlazadas a TCP/IP, que pueden incluir miniportes virtuales, filtros ligeros, adaptadores de túnel e interfaces físicas.
Sintaxis
NETIOAPI_API ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
Parámetros
InterfaceAlias [in]
Puntero a una cadena Unicode terminada en NULL que contiene el nombre de alias de la interfaz de red.InterfaceLuid [out]
Puntero a la unión de NET_LUID para la interfaz de red.
Valor devuelto
ConvertInterfaceAliasToLuid devuelve STATUS_SUCCESS si la función se realiza correctamente. Si se produce un error en la función, el parámetro InterfaceLuid se establece en NULL y ConvertInterfaceAliasToLuid devuelve el código de error siguiente:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | Uno de los parámetros no era válido. ConvertInterfaceAliasToLuid devuelve este error si InterfaceAlias o InterfaceLuid es NULL o si InterfaceAlias no es válido. |
Observaciones
La función ConvertInterfaceAliasToLuid es independiente del protocolo y funciona con interfaces de red para los protocolos IPv6 e IPv4.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |