Compartir a través de


Función ConvertInterfaceAliasToLuid (netioapi.h)

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

Consulte también

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex