Método IFilter::Init (filter.h)

Artigo
08/23/2023

Observação

O Serviço de Indexação não tem mais suporte a partir do Windows XP e não está disponível para uso a partir de Windows 8. Em vez disso, use a Pesquisa do Windows para pesquisa do lado do cliente e o Microsoft Search Server Express para pesquisa no lado do servidor.

Inicializa uma sessão de filtragem.

Sintaxe

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

Parâmetros

[in] grfFlags

Os valores da enumeração IFILTER_INIT para controlar a padronização de texto, a saída da propriedade, o escopo de inserção e os padrões de acesso IFilter .

[in] cAttributes

O tamanho da matriz de atributos. Quando diferente de zero, cAttributes tem precedência sobre atributos especificados em grfFlags. Se nenhum sinalizador de atributo for especificado e cAttributes for zero, o padrão será dado pelo conjunto de propriedades de armazenamento PSGUID_STORAGE, que contém a data e a hora da última gravação no arquivo, tamanho e assim por diante; e pela propriedade "contents" PID_STG_CONTENTS, que é mapeada para o conteúdo main do arquivo. Para obter mais informações sobre propriedades e conjuntos de propriedades, consulte Conjuntos de propriedades.

[in] aAttributes

Ponteiro para uma matriz de estruturas FULLPROPSPEC para as propriedades solicitadas. Quando cAttributes é diferente de zero, somente as propriedades em aAttributes são retornadas.

[out] pFlags

Informações sobre propriedades adicionais disponíveis para o chamador; da enumeração IFILTER_FLAGS .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	A operação foi concluída com êxito.
E_FAIL	O arquivo a ser filtrado não foi carregado anteriormente.
E_INVALIDARG	A contagem e o conteúdo dos atributos não concordam.
FILTER_E_PASSWORD	O acesso foi negado devido à proteção por senha ou a medidas de segurança semelhantes.
FILTER_E_ACCESS	Falhas gerais de acesso

Comentários

O método Init define o estado do objeto de filtro. O filtro de conteúdo posiciona no início do objeto e o estado do objeto é congelado até que o objeto seja liberado. Você pode passar ao objeto de filtro o conjunto de propriedades que deseja retornar configurando suas descrições de ID (identificador de propriedade) e conjunto de propriedades na matriz aAttributes . Para obter mais informações, consulte Filtrando propriedades de arquivo.

Anotações aos Chamadores

Chame o método Init antes de chamar todos os outros métodos IFilter .

Observações aos implementadores

As IDs de parte devem permanecer consistentes em várias chamadas para o método Init com os mesmos parâmetros.

Para algumas implementações da interface IFilter , a detecção de falha ao acessar um documento pode não ser possível (ou pode ser computacionalmente cara) até que o método Init tenha sido chamado ou possivelmente até mais tarde.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	filter.h