Função ConvertInterfaceNameToLuidW (netioapi.h)

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

Sintaxe

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

Parâmetros

[in] InterfaceName

Um ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o nome do adaptador de rede.

[out] InterfaceLuid

Um ponteiro para o NET_LUID para essa interface.

Retornar valor

Em caso de êxito, ConvertInterfaceNameToLuidW retorna NETIO_ERROR_SUCCESS. Qualquer valor retornado diferente de zero indica falha.

Código do erro Significado
ERROR_INVALID_NAME
O nome da interface era inválido. Esse erro será retornado se o parâmetro InterfaceName contiver um nome inválido ou o comprimento do parâmetro InterfaceName exceder o comprimento máximo permitido da cadeia de caracteres para esse parâmetro.
ERROR_INVALID_PARAMETER
Um dos parâmetros era inválido. Esse erro será retornado se o parâmetro InterfaceLuid for NULL.

Comentários

A função ConvertInterfaceNameToLuidW está disponível no Windows Vista e posteriores.

A função ConvertInterfaceNameToLuidW é independente de protocolo e funciona com interfaces de rede para o protocolo IPv6 e IPv4. O ConvertInterfaceNameToLuidW converte um nome de interface Unicode em um LUID.

O ConvertInterfaceNameToLuidA converte um nome de interface ANSI em um LUID.

O comprimento máximo de um nome de interface, NDIS_IF_MAX_STRING_SIZE, sem o NULL de terminação é declarado no arquivo de cabeçalho Ntddndis.h . O NDIS_IF_MAX_STRING_SIZE é definido como a constante IF_MAX_STRING_SIZE definida no arquivo de cabeçalho Ifdef.h . Os arquivos de cabeçalho Ntddndis.h e Ifdef.h são incluídos automaticamente no arquivo de cabeçalho Netioapi.h , que é incluído automaticamente pelo arquivo de cabeçalho Iphlpapi.h . Os arquivos de cabeçalho Ntddndis.h, Ifdef.h e Netioapi.h nunca devem ser usados diretamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho netioapi.h (inclua Iphlpapi.h)
Biblioteca Iphlpapi.lib
DLL Iphlpapi.dll

Confira também

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

NET_LUID

if_indextoname

if_nametoindex