Méthode IFolderFilterSite::SetFilter (shobjidl_core.h)

Exposé par un hôte pour permettre aux clients de transmettre à l’hôte leurs pointeurs d’interface IUnknown .

Syntaxe

HRESULT SetFilter(
  [in] IUnknown *punk
);

Paramètres

[in] punk

Type : IUnknown*

Pointeur vers l’interface IUnknown du client. Pour avertir l’hôte d’arrêter le filtrage et d’arrêter d’appeler votre interface IFolderFilter , définissez ce paramètre sur NULL.

Valeur retournée

Type : HRESULT

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

Remarques

Une fois que vous avez obtenu un pointeur vers l’interface IFolderFilterSite de l’hôte, appelez cette méthode pour passer à l’hôte un pointeur vers votre interface IUnknown . L’hôte utilise ensuite ce pointeur pour appeler votre méthode QueryInterface afin de demander un pointeur vers votre interface IFolderFilter . Si cet appel échoue, IFolderFilterSite::SetFilter retourne E_NOINTERFACEAVAILABLE. Si l’appel réussit, l’hôte appelle les deux méthodes de l’interface IFolderFilter pour déterminer comment énumérer le contenu du dossier.

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)
DLL	Shell32.dll