Función ConvertInterfaceNameToLuidW (netioapi.h)

Artículo
02/29/2024

La función ConvertInterfaceNameToLuidW convierte un nombre de interfaz de red Unicode en el identificador único local (LUID) de la interfaz.

Sintaxis

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidW(
  [in]  const WCHAR *InterfaceName,
  [out] NET_LUID    *InterfaceLuid
);

Parámetros

[in] InterfaceName

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

[out] InterfaceLuid

Puntero al NET_LUID para esta interfaz.

Valor devuelto

Si se ejecuta correctamente, ConvertInterfaceNameToLuidW devuelve NETIO_ERROR_SUCCESS. Cualquier valor devuelto distinto de cero indica un error.

Código de error	Significado
ERROR_INVALID_NAME	El nombre de la interfaz no era válido. Este error se devuelve si el parámetro InterfaceName contenía un nombre no válido o la longitud del parámetro InterfaceName superó la longitud máxima de cadena permitida para este parámetro.
ERROR_INVALID_PARAMETER	Uno de los parámetros no era válido. Este error se devuelve si el parámetro InterfaceLuid era NULL.

Comentarios

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

La función ConvertInterfaceNameToLuidW es independiente del protocolo y funciona con interfaces de red para el protocolo IPv6 e IPv4. ConvertInterfaceNameToLuidW convierte un nombre de interfaz Unicode en un LUID.

ConvertInterfaceNameToLuidA convierte un nombre de interfaz ANSI en un LUID.

La longitud máxima de un nombre de interfaz, NDIS_IF_MAX_STRING_SIZE, sin el valor NULL de terminación se declara en el archivo de encabezado Ntddndis.h . El NDIS_IF_MAX_STRING_SIZE se define como la constante IF_MAX_STRING_SIZE definida en el archivo de encabezado Ifdef.h . Los archivos de encabezado Ntddndis.h y Ifdef.h se incluyen automáticamente en el archivo de encabezado Netioapi.h , que el archivo de encabezado Iphlpapi.h incluye automáticamente. Los archivos de encabezado Ntddndis.h, Ifdef.h y Netioapi.h nunca se deben usar directamente.

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 (incluya Iphlpapi.h)
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll