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

Статья
08/23/2023

Примечание

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

Инициализирует сеанс фильтрации.

Синтаксис

SCODE Init(
  [in]  ULONG              grfFlags,
  [in]  ULONG              cAttributes,
  [in]  const FULLPROPSPEC *aAttributes,
  [out] ULONG              *pFlags
);

Параметры

[in] grfFlags

Значения из перечисления IFILTER_INIT для управления стандартизацией текста, выводом свойств, внедрением область и шаблонами доступа IFilter.

[in] cAttributes

Размер массива атрибутов. Если значение не равно нулю, cAttributes имеет приоритет над атрибутами, указанными в grfFlags. Если флаги атрибутов не указаны и cAttributes равно нулю, значение по умолчанию присваивается набором свойств хранилища PSGUID_STORAGE, которое содержит дату и время последней записи в файл, размер и т. д. и свойством PID_STG_CONTENTS "содержимое", которое сопоставляется с main содержимым файла. Дополнительные сведения о свойствах и наборах свойств см. в разделе Наборы свойств.

[in] aAttributes

Указатель на массив структур FULLPROPSPEC для запрошенных свойств. Если cAttributes не равно нулю, возвращаются только свойства в aAttributes .

[out] pFlags

Сведения о дополнительных свойствах, доступных вызывающей объекту; из перечисления IFILTER_FLAGS .

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

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

Код возврата	Описание
S_OK	Операция была успешно завершена.
E_FAIL	Файл для фильтрации ранее не был загружен.
E_INVALIDARG	Количество и содержимое атрибутов не согласны.
FILTER_E_PASSWORD	Доступ был отклонен из-за защиты паролем или аналогичных мер безопасности.
FILTER_E_ACCESS	Общие сбои доступа

Метод Init задает состояние объекта фильтра. Фильтр содержимого размещается в начале объекта, а состояние объекта зависает до освобождения объекта. Вы можете передать объекту фильтра набор возвращаемых свойств, настроив их набор свойств и описания идентификаторов свойств в массиве aAttributes . Дополнительные сведения см. в разделе Фильтрация свойств файла.

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

Вызовите метод Init перед вызовом всех остальных методов IFilter .

Примечания для разработчиков

Идентификаторы блоков должны оставаться согласованными при нескольких вызовах метода Init с одинаковыми параметрами.

В некоторых реализациях интерфейса IFilter обнаружение сбоя при доступе к документу может быть невозможным (или может быть дорогостоящим с точки зрения вычислений) до вызова метода Init или, возможно, даже позже.

Требования

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