IFolderFilterSite::SetFilter-Methode (shobjidl_core.h)

Wird von einem Host verfügbar gemacht, damit Clients dem Host ihre IUnknown-Schnittstellenzeiger übergeben können.

Syntax

HRESULT SetFilter(
  [in] IUnknown *punk
);

Parameter

[in] punk

Typ: IUnknown*

Ein Zeiger auf die IUnknown-Schnittstelle des Clients. Legen Sie diesen Parameter auf NULL fest, um den Host zu benachrichtigen, die Filterung zu beenden und den Aufruf Ihrer IFolderFilter-Schnittstelle zu beenden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Nachdem Sie einen Zeiger auf die IFolderFilterSite-Schnittstelle des Hosts erhalten haben, rufen Sie diese Methode auf, um dem Host einen Zeiger auf Ihre IUnknown-Schnittstelle zu übergeben. Der Host verwendet diesen Zeiger dann, um Ihre QueryInterface-Methode aufzurufen, um einen Zeiger auf Ihre IFolderFilter-Schnittstelle anzufordern. Wenn dieser Aufruf fehlschlägt, gibt IFolderFilterSite::SetFilterE_NOINTERFACEAVAILABLE zurück. Wenn der Aufruf erfolgreich ist, ruft der Host dann die beiden Methoden der IFolderFilter-Schnittstelle auf, um zu bestimmen, wie der Inhalt des Ordners aufgezählt werden soll.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll