Метод 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

См. также

IWDTFTarget2