Поделиться через


Метод IFilter::GetValue (filter.h)

Примечание

Служба индексирования больше не поддерживается в Windows XP и недоступна для использования в Windows 8. Вместо этого используйте Windows Search для поиска на стороне клиента и Microsoft Search Server Express для поиска на стороне сервера.

Извлекает значение (внутреннее свойство типа значения) из блока, который должен иметь значение перечисления CHUNKSTATE , равное CHUNK_VALUE.

Синтаксис

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

Параметры

[out] ppPropValue

Указатель на выходную переменную, получающую указатель на структуру PROPVARIANT , содержащую свойство типа значения.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
Операция успешно завершена.
FILTER_E_NO_MORE_VALUES
Метод GetValue уже был вызван для этого блока; Это значение должно возвращаться до тех пор, пока метод IFilter::GetChunk не будет успешно вызван и не перейдет к следующему блоку.
FILTER_E_NO_VALUES
Текущий блок не имеет значения перечисления CHUNKSTATE CHUNK_VALUE.

Комментарии

Вызовите метод GetValue только один раз на блок.

Обратите внимание, что эффект создания одного и того же значения из нескольких блоков не определен. Допустимы только последние значения.

Примечания к вызывающим абонентам

Выделите структуру PROPVARIANT с помощью CoTaskMemAlloc. Некоторые структуры PROPVARIANT содержат указатели, которые можно освободить, вызвав функцию PropVariantClear . Вызов PropVariantClear выполняется вызывающей стороны метода GetValue.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header filter.h

См. также раздел

Ifilter