Función ConvertInterfaceNameToLuidA (netioapi.h)

Artículo
03/15/2023

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

Sintaxis

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

Parámetros

[in] InterfaceName

Puntero a una cadena ANSI 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, ConvertInterfaceNameToLuidA devuelve NETIO_ERROR_SUCCESS. Cualquier valor devuelto distinto de cero indica un error.

Código de error	Significado
ERROR_BUFFER_OVERFLOW	La longitud del nombre de la interfaz ANSI no era válida. Este error se devuelve si el parámetro InterfaceName superó la longitud máxima de cadena permitida para este parámetro.
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.
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 ConvertInterfaceNameToLuidA está disponible en Windows Vista y versiones posteriores.

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

ConvertInterfaceNameToLuidW convierte un nombre de interfaz Unicode 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