Función ConvertInterfaceNameToLuidA
La función ConvertInterfaceNameToLuidA convierte un nombre de interfaz de red ANSI en el identificador único local (LUID) de la interfaz.
Nota
La familia ConvertInterfaceXxx API 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 ConvertInterfaceNameToLuidA(
_In_ const CHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parámetros
InterfaceName [in]
Puntero a una cadena ANSI terminada en NULL que contiene el nombre de la interfaz de red.InterfaceLuid [out]
Puntero a la unión de NET_LUID para esta interfaz.
Valor devuelto
ConvertInterfaceNameToLuidA devuelve STATUS_SUCCESS si la función se realiza correctamente. Si se produce un error en la función, ConvertInterfaceNameToLuidA devuelve uno de los siguientes códigos de error:
| Código devuelto | Descripción |
|---|---|
| ERROR_BUFFER_OVERFLOW | La longitud del nombre de la interfaz ANSI no es válida. ConvertInterfaceNameToLuidA devuelve este error si el parámetro InterfaceName supera la longitud máxima de cadena permitida para este parámetro. |
| STATUS_INVALID_NAME | El nombre de la interfaz no es válido. ConvertInterfaceNameToLuidA devuelve este error si el parámetro InterfaceName contiene un nombre de interfaz no válido. |
| STATUS_INVALID_PARAMETER | Uno de los parámetros no es válido. ConvertInterfaceNameToLuidA devuelve este error si el parámetro InterfaceLuid es NULL. |
Observaciones
La función ConvertInterfaceNameToLuidA 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 valor 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 e Ifdef.h se incluyen automáticamente en el archivo de encabezado Netioapi.h . Nunca debe usar los archivos de encabezado Ntddndis.h e Ifdef.h directamente.
Use la función ConvertInterfaceNameToLuidW para convertir un nombre de interfaz Unicode 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 |