Función ConvertInterfaceAliasToLuid (netioapi.h)

Artículo
03/13/2024

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.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

Parámetros

[in] InterfaceAlias

Puntero a una cadena Unicode terminada en NULL que contiene el nombre de alias de la interfaz de red.

[out] InterfaceLuid

Puntero al NET_LUID para esta interfaz.

Valor devuelto

Si se ejecuta correctamente, ConvertInterfaceAliasToLuid devuelve NO_ERROR. Cualquier valor devuelto distinto de cero indica un error y se devuelve un valor NULL en el parámetro InterfaceLuid .

Código de error	Significado
ERROR_INVALID_PARAMETER	Uno de los parámetros no era válido. Este error se devuelve si el parámetro InterfaceAlias o InterfaceLuid era NULL o si el parámetro InterfaceAlias no era válido.

Comentarios

La función ConvertInterfaceAliasToLuid está disponible en Windows Vista y versiones posteriores.

La función ConvertInterfaceAliasToLuid es independiente del protocolo y funciona con interfaces de red para el protocolo IPv6 e IPv4.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	netioapi.h (include Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll