Método IWDTFTarget2::GetValue (wdtf.h)
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 |