Share via

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

  • Artigo

Retorna um valor do destino associado a um atributo especificado.

Sintaxe

HRESULT GetValue(
  [in]          BSTR    SDEL,
  [out, retval] VARIANT *pValue
);

Parâmetros

[in] SDEL

Uma instrução SDEL que especifica o valor do atributo a ser recuperado.

[out, retval] pValue

O endereço de uma variável que recebe o resultado desse método. O resultado pode ser qualquer VARIANT compatível com automação.

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

Especifique o campo que o método GetValue recupera usando uma instrução SDEL regular. Normalmente, uma instrução SDEL pode conter operadores de comparação e especificadores de valor para executar correspondências. No entanto, você não precisa desses itens para que GetValue funcione corretamente.

Para cada campo especificado na instrução SDEL (incluindo iteração em um conjunto de relações), esse método coleta um conjunto de valores VARIANT (não VT_EMPTY). Se apenas um valor for encontrado, essa VARIANT será retornada. Se mais de um valor for encontrado, os valores serão empacotados em uma VARIANT que contém um SAFEARRAY. Se nenhum valor for encontrado, o método retornará um VARIANT que contém VT_EMPTY.

Além disso, o operador AND permitirá a coleta dos valores em ambos os lados de si mesmo, mas OR permitirá a coleta apenas do primeiro valor encontrado (começando pela esquerda).

Para obter mais informações sobre como usar GetValue, consulte 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