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 |