IProtocolHandlerSite::GetFilter-Methode (searchapi.h)

Artikel
03/01/2024

Ruft den entsprechenden IFilter gemäß den angegebenen Parametern ab.

Syntax

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

Parameter

[in] pclsidObj

Typ: CLSID*

Zeiger auf die CLSID des Dokumenttyps aus der Registrierung. Dies wird für Elemente mit eingebetteten Dokumenten verwendet, um den entsprechenden IFilter anzugeben, der für dieses eingebettete Dokument verwendet werden soll.

[in] pcwszContentType

Typ: LPCWSTR

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Typ des Dokuments enthält. Dies wird verwendet, um IFilterabzurufen , die entsprechend dem MIME-Typ zugeordnet sind.

[in] pcwszExtension

Typ: LPCWSTR

Zeiger auf eine unicode-Zeichenfolge, die null beendet wurde, die die Dateinamenerweiterung ohne den vorherigen Punkt enthält. Dies wird verwendet, um IFilter-Objekte abzurufen, die gemäß der Dateinamenerweiterung zugeordnet sind.

[out] ppFilter

Typ: IFilter**

Empfängt die Adresse eines Zeigers auf den IFilter , den der Protokollhandler verwendet.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode fragt den Filterhost ab, um das geeignete IFilter-Objekt zu identifizieren, das für das URL-Element verwendet werden soll.

Die Auswahl des Filters basiert auf der Dateinamenerweiterung, einer CLSID, die den Inhaltstyp der Datei in der Registrierung identifiziert, oder auf dem MIME-Inhaltstyp. Sie müssen nur einen der drei Parameter für diese Methode angeben. Wenn Sie mehrere Parameter angeben, werden diese in der folgenden Reihenfolge getestet: pcwszContentType, pclsidObj, pcwszExtension. Der erste gültige Parameter wird verwendet, um den entsprechenden IFilter auszuwählen. die anderen werden ignoriert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	searchapi.h
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über