Função ConvertInterfaceGuidToLuid

A função ConvertInterfaceGuidToLuid converte um identificador global exclusivo (GUID) para uma interface de rede para o identificador exclusivo local (LUID) para a interface.

Observação

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

Sintaxe

NETIOAPI_API ConvertInterfaceGuidToLuid(
  _In_  const GUID      *InterfaceGuid,
  _Out_       PNET_LUID InterfaceLuid
);

Parâmetros

InterfaceGuid [em]
Um ponteiro para um GUID para a interface de rede.
InterfaceLuid [saída]
Um ponteiro para a união de NET_LUID para a interface de rede.

Valor de retorno

ConvertInterfaceGuidToLuid retorna STATUS_SUCCESS se a função for bem-sucedida. Se a função falhar, o parâmetro InterfaceLuid é definido como NULL e ConvertInterfaceGuidToLuid retornará o seguinte código de erro:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um dos parâmetros era inválido. ConvertInterfaceGuidToLuid retornará esse erro se InterfaceAlias ou InterfaceLuid for NULL ou se InterfaceGuid for inválido.

Comentários

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

Requerimentos

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