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

Article
02/28/2024

Notes

Le service d’indexation n’est plus pris en charge à partir de Windows XP et n’est plus disponible depuis Windows 8. Utilisez plutôt Windows Search pour la recherche côté client et Microsoft Search Server Express pour la recherche côté serveur.

Initialise une session de filtrage.

Syntaxe

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

Paramètres

[in] grfFlags

Les valeurs de l’énumération IFILTER_INIT pour contrôler la standardisation du texte, la sortie des propriétés, l’étendue d’incorporation et les modèles d’accès IFilter .

[in] cAttributes

Taille du tableau d’attributs. Lorsque ce n’est pas zéro, cAttributes est prioritaire sur les attributs spécifiés dans grfFlags. Si aucun indicateur d’attribut n’est spécifié et que cAttributes est égal à zéro, la valeur par défaut est donnée par le jeu de propriétés de stockage PSGUID_STORAGE, qui contient la date et l’heure de la dernière écriture dans le fichier, la taille, et ainsi de suite ; et par la propriété « contents » PID_STG_CONTENTS, qui correspond au contenu main du fichier. Pour plus d’informations sur les propriétés et les jeux de propriétés, consultez Jeux de propriétés.

[in] aAttributes

Pointeur vers un tableau de structures FULLPROPSPEC pour les propriétés demandées. Lorsque cAttributes est différent de zéro, seules les propriétés dans unAttributes sont retournées.

[out] pFlags

Informations sur les propriétés supplémentaires disponibles pour l’appelant ; de l’énumération IFILTER_FLAGS .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	L’opération a été effectuée avec succès.
E_FAIL	Le fichier à filtrer n’a pas été chargé précédemment.
E_INVALIDARG	Le nombre et le contenu des attributs ne sont pas d’accord.
FILTER_E_PASSWORD	L’accès a été refusé en raison de la protection par mot de passe ou de mesures de sécurité similaires.
FILTER_E_ACCESS	Échecs d’accès généraux

Remarques

La méthode Init définit l’état de l’objet filter. Le filtre de contenu se positionne au début de l’objet et l’état de l’objet est figé jusqu’à ce que l’objet soit libéré. Vous pouvez transmettre à l’objet filtre le jeu de propriétés que vous souhaitez renvoyer en configurant leur jeu de propriétés et leurs descriptions d’identificateur de propriété (ID) dans le tableau aAttributes . Pour plus d’informations, consultez Filtrage des propriétés de fichier.

Remarques aux appelants

Appelez la méthode Init avant d’appeler toutes les autres méthodes IFilter .

Remarques aux implémenteurs

Les ID de bloc doivent rester cohérents sur plusieurs appels à la méthode Init avec les mêmes paramètres.

Pour certaines implémentations de l’interface IFilter , la détection d’un échec d’accès à un document peut ne pas être possible (ou peut être coûteuse en calcul) tant que la méthode Init n’a pas été appelée, voire plus tard.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	filter.h