Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 NET_LUID para la interfaz de red.
Valor devuelto
convertInterfaceAliasToLuid devuelve STATUS_SUCCESS si la función se ejecuta correctamente. Si se produce un error en la función, el parámetro InterfaceLuid se establece en NULLy ConvertInterfaceAliasToLuid devuelve el siguiente código de error:
| 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 |