Compartilhar via


Método GetFilter

Obtém o apropriado filtro de acordo com os parâmetros que são fornecidos.

                      
HRESULT GetFilter(
CLSID *pclsidObj,
LPCWSTR pcwszContentType,
LPCWSTR pcwszExtension,
IFilter **ppFilter
);
                    

Parâmetros

pclsidObj

[no] Ponteiro para o identificação de classe ( CLSID) para tipo de documento a partir de Registro. Esse ponteiro indica o apropriado filtro a ser usado para um incorporado documento em um item.

pcwszContentType

[no] Ponteiro para uma seqüência de caracteres Unicode NULL-Terminated, que contém o tipo do documento. Esse ponteiro é usado para recuperar filtros que são mapeados de acordo com o tipo MIME (MIME).

pcwszExtension

[no] Ponteiro para uma seqüência de caracteres Unicode NULL-Terminated, que contém o extensão de nome de arquivo, sem a acima período. Esse ponteiro é usado para recuperar filtros que são mapeados para o extensão de nome de arquivo especificado.

ppFilter

[out] Endereço do ponteiro para o filtro usado pelo manipulador de protocolo.

Retornar valor

Se bem-sucedido, retorna S_OK; caso contrário, retorna um valor de erro. Para obter uma lista das mensagens de erro retornadas pelo Pesquisa da empresa no Microsoft Office do SharePoint Server 2007, consulte Mensagens de Erro do identificador de protocolo.

Comentários

Se um manipulador protocolo requer um filtro para um incorporado documento, ele pode get-lo por chamado esse método. Este método consultará o daemon de filtro para o apropriado de filtro a ser usado para o de conteúdo item.

A escolha do filtro é baseada no extensão de nome de arquivo, um CLSID que identificado de conteúdo do arquivo no Registro, ou no tipo de conteúdo MIME. Você deve fornecer somente um dos três parâmetros. Se você fornecer múltiplo parâmetros, eles são testados no seguinte ordem:

  1. pcwszContentType

  2. pclsidObj

  3. pcwszExtension

O método usa o válido primeiro parâmetro para selecionar o apropriado filtro; o método ignora as outras.

Consulte também

Outros recursos

Referência do identificador de protocolo
Interface IProtocolHandlerSite