Метод IWDTFTarget2::GetValue (wdtf.h)
Возвращает значение из целевого объекта, связанного с указанным атрибутом.
Синтаксис
HRESULT GetValue(
[in] BSTR SDEL,
[out, retval] VARIANT *pValue
);
Параметры
[in] SDEL
Оператор SDEL, указывающий значение атрибута для извлечения.
[out, retval] pValue
Адрес переменной, получающей результат этого метода. Результатом может быть любой вариант variant, совместимый с автоматизацией.
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Укажите поле, извлекаемое методом GetValue , с помощью обычной инструкции SDEL . Как правило, инструкция SDEL может содержать операторы сравнения и описатели значений для выполнения совпадений. Однако эти элементы не нужны для правильной работы GetValue .
Для каждого поля, указанного в инструкции SDEL (включая итерацию по набору связей), этот метод собирает набор значений VARIANT (не VT_EMPTY). Если найдено только одно значение, возвращается значение VARIANT . Если найдено несколько значений, значения упаковываются в variant , содержащий SAFEARRAY. Если значения не найдены, метод возвращает variant , содержащий VT_EMPTY.
Кроме того, оператор AND разрешает сбор значений с обеих сторон от себя, но OR разрешает сбор только первого найденного значения (начиная с левого).
Дополнительные сведения об использовании GetValue см. в статье Общие сведения о языке оценки простых данных.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP Professional |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdtf.h |