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

Article
03/04/2024

Récupère l’IFilter approprié en fonction des paramètres fournis.

Syntaxe

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

Paramètres

[in] pclsidObj

Type : CLSID*

Pointeur vers le CLSID du type de document du Registre. Cela est utilisé pour les éléments avec des documents incorporés afin d’indiquer l’IFilter approprié à utiliser pour ce document incorporé.

[in] pcwszContentType

Type : LPCWSTR

Pointeur vers une chaîne Unicode terminée par null qui contient le type du document. Il est utilisé pour récupérer des IFilterqui sont mappés en fonction du type MIME.

[in] pcwszExtension

Type : LPCWSTR

Pointeur vers une chaîne Unicode terminée par null qui contient l’extension de nom de fichier, sans la période précédente. Il permet de récupérer des objets IFilter mappés en fonction de l’extension de nom de fichier.

[out] ppFilter

Type : IFilter**

Reçoit l’adresse d’un pointeur vers l’IFilter que le gestionnaire de protocole utilise.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode interroge l’hôte de filtre pour identifier l’objet IFilter approprié à utiliser pour l’élément d’URL.

Le choix du filtre est basé sur l’extension de nom de fichier, un CLSID qui identifie le type de contenu du fichier dans le Registre ou sur le type de contenu MIME. Vous devez fournir un seul des trois paramètres à cette méthode. Si vous fournissez plusieurs paramètres, ils sont testés dans l’ordre suivant : pcwszContentType, pclsidObj, pcwszExtension. Le premier paramètre valide est utilisé pour sélectionner le filtre IFilter approprié ; les autres sont ignorés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	searchapi.h
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Partager via