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

Artículo
03/05/2024

Nota

El servicio de indexación ya no se admite a partir de Windows XP y no está disponible para su uso a partir de Windows 8. En su lugar, use Windows Search para la búsqueda del lado cliente y Microsoft Search Server Express para la búsqueda del lado servidor.

Inicializa una sesión de filtrado.

Sintaxis

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

Parámetros

[in] grfFlags

Valores de la enumeración IFILTER_INIT para controlar la normalización de texto, la salida de propiedad, el ámbito de inserción y los patrones de acceso de IFilter .

[in] cAttributes

Tamaño de la matriz de atributos. Cuando no es cero, cAttributes tiene prioridad sobre los atributos especificados en grfFlags. Si no se especifican marcas de atributo y cAttributes es cero, la propiedad de almacenamiento PSGUID_STORAGE establece el valor predeterminado, que contiene la fecha y hora de la última escritura en el archivo, el tamaño, etc. y por la propiedad PID_STG_CONTENTS 'contents', que se asigna al contenido principal del archivo. Para obtener más información sobre las propiedades y los conjuntos de propiedades, vea Conjuntos de propiedades.

[in] aAttributes

Puntero a una matriz de estructuras FULLPROPSPEC para las propiedades solicitadas. Cuando cAttributes es distinto de cero, solo se devuelven las propiedades de aAttributes .

[out] pFlags

Información sobre las propiedades adicionales disponibles para el autor de la llamada; de la enumeración IFILTER_FLAGS .

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La operación se completó correctamente.
E_FAIL	El archivo que se va a filtrar no se cargó previamente.
E_INVALIDARG	El recuento y el contenido de los atributos no están de acuerdo.
FILTER_E_PASSWORD	Se ha denegado el acceso debido a la protección con contraseña o a medidas de seguridad similares.
FILTER_E_ACCESS	Errores de acceso general

Comentarios

El método Init establece el estado del objeto de filtro. Las posiciones del filtro de contenido al principio del objeto y el estado del objeto se inmovilizan hasta que se libera el objeto. Puede pasar el objeto de filtro el conjunto de propiedades que desea devolver configurando sus descripciones del conjunto de propiedades y el identificador de propiedad (ID) en la matriz aAttributes . Para obtener más información, vea Filtrar propiedades de archivo.

Notas a los autores de llamadas

Llame al método Init antes de llamar a todos los demás métodos IFilter .

Notas para los implementadores

Los identificadores de fragmento deben ser coherentes en varias llamadas al método Init con los mismos parámetros.

En algunas implementaciones de la interfaz IFilter , es posible que la detección de errores de acceso a un documento no sea posible (o puede ser costosa a nivel computacional) hasta que se haya llamado al método Init o, posiblemente, incluso más tarde.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	filter.h