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

Recupera o IFilter apropriado de acordo com os parâmetros fornecidos.

Sintaxe

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

Parâmetros

[in] pclsidObj

Tipo: CLSID*

Ponteiro para o CLSID do tipo de documento do registro. Isso é usado para itens com documentos inseridos para indicar o IFilter apropriado a ser usado para esse documento inserido.

[in] pcwszContentType

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o tipo do documento. Isso é usado para recuperar IFilters mapeados de acordo com o tipo MIME.

[in] pcwszExtension

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a extensão de nome de arquivo, sem o período anterior. Isso é usado para recuperar objetos IFilter mapeados de acordo com a extensão de nome de arquivo.

[out] ppFilter

Tipo: IFilter**

Recebe o endereço de um ponteiro para o IFilter que o manipulador de protocolo usa.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método consulta o Host de Filtro para identificar o objeto IFilter apropriado a ser usado para o item de URL.

A escolha do filtro é baseada na extensão de nome de arquivo, um CLSID que identifica o tipo de conteúdo do arquivo no registro ou no tipo de conteúdo MIME. Você precisa fornecer apenas um dos três parâmetros para esse método. Se você fornecer vários parâmetros, eles serão testados na seguinte ordem: pcwszContentType, pclsidObj, pcwszExtension. O primeiro parâmetro válido é usado para selecionar o IFilter apropriado; os outros são ignorados.

Requisitos