GetFilter, méthode
Obtient le filtre approprié en fonction des paramètres fournis.
HRESULT GetFilter(
CLSID *pclsidObj,
LPCWSTR pcwszContentType,
LPCWSTR pcwszExtension,
IFilter **ppFilter
);
Paramètres
pclsidObj
[in] Pointeur vers l'ID de classe (CLSID) pour le type de document du Registre. Ce pointeur indique le filtre approprié à utiliser pour un document incorporé dans un élément.
pcwszContentType
[in] Pointeur vers une chaîne Unicode, terminée par un caractère nul, qui contient le type de document. Ce pointeur permet de récupérer les filtres qui sont mappés conformément au type MIME (Multipurpose Internet Mail Extensions).
pcwszExtension
[in] Pointeur vers une chaîne Unicode, terminée par un caractère nul, qui contient l'extension du nom de fichier, sans le point précédent. Ce pointeur permet de récupérer les filtres qui sont mappés sur l'extension du nom de fichier spécifiée.
ppFilter
[out] Adresse du pointeur vers le filtre utilisé par le gestionnaire de protocole.
Valeur de retour
En cas de réussite, retourne S_OK ; sinon retourne une valeur d'erreur. Pour obtenir la liste des messages d'erreur retournés par Recherche de contenu d'entreprise dans Microsoft Office SharePoint Server 2007, voir Messages d'erreur des gestionnaires de protocole.
Remarques
Si un gestionnaire de protocole nécessite un filtre pour un document incorporé, il peut l'obtenir en appelant cette méthode. Cette méthode interroge le démon de filtre pour obtenir le filtre approprié à utiliser pour l'élément de contenu.
Le choix du filtre repose sur l'extension du nom de fichier, un CLSID qui a identifié le contenu du fichier dans le Registre ou sur le type de contenu MIME. Vous devez spécifier un seul des trois paramètres. Si vous indiquez plusieurs paramètres, ils sont testés dans l'ordre suivant :
pcwszContentType
pclsidObj
pcwszExtension
La méthode utilise le premier paramètre valide pour sélectionner le filtre approprié et ignore les autres.
Voir aussi
Autres ressources
Référence du gestionnaire de protocole
IProtocolHandlerSite, interface