Leer en inglés

Compartir a través de


Función ConvertInterfaceNameToLuidW

La función ConvertInterfaceNameToLuidW convierte un nombre de interfaz de red Unicode 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 ConvertInterfaceNameToLuidW(
  _In_  const WCHAR    *InterfaceName,
  _Out_       NET_LUID *InterfaceLuid
);

Parámetros

  • InterfaceName [in]
    Puntero a una cadena Unicode terminada en NULL que contiene el nombre de la interfaz de red.

  • InterfaceLuid [out]
    Puntero a la unión NET_LUID para esta interfaz.

Valor devuelto

ConvertInterfaceNameToLuidW devuelve STATUS_SUCCESS si la función se realiza correctamente. Si se produce un error en la función, ConvertInterfaceNameToLuidW devuelve uno de los siguientes códigos de error:

Código devuelto Descripción
STATUS_INVALID_NAME

El nombre de la interfaz no es válido. ConvertInterfaceNameToLuidW devuelve este error si el parámetro InterfaceName contiene un nombre no válido o la longitud del parámetro InterfaceName supera la longitud máxima permitida de la cadena para este parámetro.

STATUS_INVALID_PARAMETER

Uno de los parámetros no es válido. ConvertInterfaceNameToLuidW devuelve este error si el parámetro InterfaceLuid es NULL.

Observaciones

La función ConvertInterfaceNameToLuidW es independiente del protocolo y funciona con interfaces de red para los protocolos IPv6 e IPv4.

La longitud máxima del nombre de la interfaz de red, NDIS_IF_MAX_STRING_SIZE, sin el carácter NULL de terminación, se define en el archivo de encabezado Ntddndis.h. NDIS_IF_MAX_STRING_SIZE se define como la constante IF_MAX_STRING_SIZE, que se define en el archivo de encabezado Ifdef.h.

Nota

Los archivos de encabezado Ntddndis.h y Ifdef.h se incluyen automáticamente en el archivo de encabezado Netioapi.h . Nunca debe usar los archivos de encabezado Ntddndis.h y Ifdef.h directamente.

Use la función ConvertInterfaceNameToLuidA para convertir un nombre de interfaz ANSI en un LUID.

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

Consulte también

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

NET_LUID