Método IWDTFTarget2::GetRelations (wdtf.h)

  • Artigo

Retorna uma coleção de destinos relacionados.

Sintaxe

HRESULT GetRelations(
  [in]          BSTR          RelationSDEL,
  [in]          BSTR          MatchSDEL,
  [out, retval] IWDTFTargets2 **ppRelations
);

Parâmetros

[in] RelationSDEL

Uma instrução SDEL que contém um ou mais tokens de relação que especificam os destinos desejados.

[in] MatchSDEL

A instrução SDEL que cada destino retornado deve corresponder. Se MatchSDEL estiver vazio, todos os destinos serão retornados.

[out, retval] ppRelations

O endereço da variável que receberá o resultado desse método.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Use o método GetRelations para recuperar instâncias relacionadas da interface IWDTFTarget2 . Especifique os destinos desejados por uma instrução SDEL de relação. Normalmente, uma instrução SDEL pode conter tokens de atributo, operadores de comparação e especificadores de valor para executar correspondências. No entanto, você não precisa desses itens no parâmetro RelationSDEL para que o método GetRelations funcione corretamente (o parâmetro MatchSDEL segue as regras para o método IWDTFTarget2::Eval ).

O método IWDTFTarget2:GetRelations coloca todos os destinos relacionados que GetRelations localiza pela instrução RelationSDEL em uma nova coleção.

GetRelations retorna apenas o subconjunto de destinos que atendem às restrições de parâmetro MatchSDEL . Se a cadeia de caracteres de parâmetro MatchSDEL estiver vazia, GetRelations retornará toda a coleção de destinos. Esse processo filtra todos os destinos que retornam VARIANT_FALSE quando você fornece MatchSDEL ao método IWDTFTarget2::Eval do destino.

Para obter mais informações sobre como usar o método GetRelations , confira Visão geral da linguagem de avaliação de dados simples.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Professional
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Área de Trabalho
Cabeçalho wdtf.h

Confira também

IWDTFTarget2