Метод IProtocolHandlerSite::GetFilter (searchapi.h)

Извлекает соответствующий IFilter в соответствии с указанными параметрами.

Синтаксис

HRESULT GetFilter(
  [in]  CLSID   *pclsidObj,
  [in]  LPCWSTR pcwszContentType,
  [in]  LPCWSTR pcwszExtension,
  [out] IFilter **ppFilter
);

Параметры

[in] pclsidObj

Тип: CLSID*

Указатель на CLSID типа документа из реестра. Он используется для элементов с внедренными документами, чтобы указать соответствующий фильтр IFilter , используемый для этого внедренного документа.

[in] pcwszContentType

Тип: LPCWSTR

Указатель на строку Юникода, завершающуюся null, которая содержит тип документа. Используется для получения IFilter, сопоставленных в соответствии с типом MIME.

[in] pcwszExtension

Тип: LPCWSTR

Указатель на строку Юникода, завершающуюся null, которая содержит расширение имени файла без предыдущей точки. Используется для получения объектов IFilter , сопоставленных в соответствии с расширением имени файла.

[out] ppFilter

Тип: IFilter**

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод запрашивает узел фильтра, чтобы определить соответствующий объект IFilter , который будет использоваться для элемента URL-адреса.

Выбор фильтра зависит от расширения имени файла, идентификатора CLSID, который определяет тип контента файла в реестре, или типа контента MIME. Для этого метода необходимо указать только один из трех параметров. Если указать несколько параметров, они проверяются в следующем порядке: pcwszContentType, pclsidObj, pcwszExtension. Первый допустимый параметр используется для выбора соответствующего IFilter; остальные игнорируются.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2), Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 с пакетом обновления 1 (SP1) [только классические приложения]
Целевая платформа	Windows
Header	searchapi.h
Распространяемые компоненты	Windows Desktop Search (WDS) 3.0