Compartir a través de

Método IProtocolHandlerSite::GetFilter (searchapi.h)

  • Artículo

Recupera el IFilter adecuado según los parámetros proporcionados.

Sintaxis

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

Parámetros

[in] pclsidObj

Tipo: CLSID*

Puntero al CLSID del tipo de documento del Registro. Esto se usa para los elementos con documentos incrustados para indicar el IFilter adecuado que se va a usar para ese documento incrustado.

[in] pcwszContentType

Tipo: LPCWSTR

Puntero a una cadena Unicode terminada en null que contiene el tipo del documento. Se usa para recuperar IFilters asignados según el tipo MIME.

[in] pcwszExtension

Tipo: LPCWSTR

Puntero a una cadena Unicode terminada en null que contiene la extensión de nombre de archivo, sin el punto anterior. Se usa para recuperar objetos IFilter asignados según la extensión de nombre de archivo.

[out] ppFilter

Tipo: IFilter**

Recibe la dirección de un puntero al IFilter que usa el controlador de protocolo.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método consulta el host de filtro para identificar el objeto IFilter adecuado que se va a usar para el elemento de dirección URL.

La elección del filtro se basa en la extensión de nombre de archivo, un CLSID que identifica el tipo de contenido del archivo en el registro o en el tipo de contenido MIME. Debe proporcionar solo uno de los tres parámetros a este método. Si proporciona varios parámetros, se prueban en el orden siguiente: pcwszContentType, pclsidObj, pcwszExtension. El primer parámetro válido se usa para seleccionar el IFilter adecuado; los demás se omiten.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado searchapi.h
Redistribuible Búsqueda de escritorio de Windows (WDS) 3.0