Compartilhar via


Função ConvertInterfaceIndexToLuid (netioapi.h)

A função ConvertInterfaceIndexToLuid converte um índice local para um adaptador de rede para o LUID (identificador local exclusivo) para a interface.

Sintaxe

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceIndexToLuid(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PNET_LUID   InterfaceLuid
);

Parâmetros

[in] InterfaceIndex

O valor do índice local para um adaptador de rede.

[out] InterfaceLuid

Um ponteiro para o NET_LUID para essa interface.

Retornar valor

Em caso de êxito, ConvertInterfaceIndexToLuid retorna NO_ERROR. Qualquer valor retornado diferente de zero indica falha e um NULL é retornado no parâmetro InterfaceLuid .

Código do erro Significado
ERROR_FILE_NOT_FOUND
O sistema não pode encontrar o arquivo especificado. Esse erro será retornado se o adaptador de rede especificado pelo parâmetro InterfaceIndex não for um valor no computador local.
ERROR_INVALID_PARAMETER
Um dos parâmetros era inválido. Esse erro será retornado se o parâmetro InterfaceLuid for NULL ou se o parâmetro InterfaceIndex for inválido.

Comentários

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

A função ConvertInterfaceIndexToLuid é independente de protocolo e funciona com interfaces de rede para o protocolo IPv6 e IPv4.

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

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID

if_indextoname

if_nametoindex