Função ConvertInterfaceLuidToNameW

Artigo
06/15/2023

A função ConvertInterfaceLuidToNameW converte um LUID (identificador local exclusivo) para um adaptador de rede para o nome da interface Unicode.

Observação

A família de API ConvertInterfaceXxx enumera identificadores em todas as interfaces associadas ao TCP/IP, que podem incluir miniportos virtuais, filtros leves, adaptadores de túnel e interfaces físicas.

Sintaxe

NETIOAPI_API ConvertInterfaceLuidToNameW(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PWSTR    InterfaceName,
  _In_        SIZE_T   Length
);

Parâmetros

InterfaceLuid [in]
Um ponteiro para uma união NET_LUID para o adaptador de rede.
InterfaceName [out]
Um ponteiro para um buffer para manter a cadeia de caracteres Unicode terminada em NULL. Se ConvertInterfaceLuidToNameW retornar com êxito, InterfaceName conterá o nome da interface Unicode.
Comprimento [in]
O comprimento do buffer, por contagem de caracteres, para o qual o parâmetro InterfaceName aponta. Esse valor deve ser grande o suficiente para manter o nome da interface e o caractere NULL de terminação. O comprimento máximo permitido é NDIS_IF_MAX_STRING_SIZE + 1. Para obter mais informações sobre NDIS_IF_MAX_STRING_SIZE, consulte a seção Comentários a seguir.

Valor retornado

ConvertInterfaceLuidToNameW retornará STATUS_SUCCESS se a função for bem-sucedida. Se a função falhar, ConvertInterfaceLuidToNameW retornará um dos seguintes códigos de erro:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um dos parâmetros é inválido. ConvertInterfaceLuidToNameW retornará esse erro se InterfaceLuid ou InterfaceName for NULL ou se InterfaceLuid for inválido.
STATUS_NOT_ENOUGH_MEMORY	ConvertInterfaceLuidToNameW retornará esse erro se o buffer InterfaceName não for tão grande quanto especificado no parâmetro Length e, portanto, o buffer não puder conter o nome da interface.

Comentários

A função ConvertInterfaceLuidToNameW é independente de protocolo e funciona com adaptadores de rede para os protocolos IPv6 e IPv4.

O comprimento máximo do nome do adaptador de rede, NDIS_IF_MAX_STRING_SIZE, sem o caractere NULL de terminação, é definido no arquivo de cabeçalho Ntddndis.h. O NDIS_IF_MAX_STRING_SIZE é definido como a constante IF_MAX_STRING_SIZE, que é definida no arquivo de cabeçalho Ifdef.h.

Observação

Os arquivos de cabeçalho Ntddndis.h e Ifdef.h são incluídos automaticamente no arquivo de cabeçalho Netioapi.h . Você nunca deve usar os arquivos de cabeçalho Ntddndis.h e Ifdef.h diretamente.

Use ConvertInterfaceLuidToNameA para converter um LUID de adaptador de rede em um nome de interface ANSI.

Requisitos

Plataforma de destino	Universal
Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Netioapi.h (inclua Netioapi.h)
Biblioteca	Netio.lib
IRQL	PASSIVE_LEVEL