ILoadFilter::LoadIFilter-Methode (filtereg.h)

Ruft den am besten geeigneten Filter ab, der einer Shell-Datenquelle zugeordnet ist, und lädt ihn.

Syntax

HRESULT LoadIFilter(
  [in]      LPCWSTR               pwcsPath,
  [in]      FILTERED_DATA_SOURCES *pFilteredSources,
  [in]      IUnknown              *pUnkOuter,
  [in]      BOOL                  fUseDefault,
  [in, out] CLSID                 *pFilterClsid,
  [in, out] int                   *SearchDecSize,
  [in, out] WCHAR                 **pwcsSearchDesc,
  [in, out] IFilter               **ppIFilt
);

Parameter

[in] pwcsPath

Zeiger auf einen durch Kommas getrennten Unicode-Zeichenfolgenpuffer, der den Pfad der zu filternden Datei angibt. Dieser Parameter kann NULL sein.

[in] pFilteredSources

Zeiger auf die FILTERED_DATA_SOURCES-Struktur , die Parameter für eine Shell-Datenquelle angibt, für die ein Filter geladen wird. Dieser Parameter darf nicht NULL sein.

[in] pUnkOuter

Wenn das Objekt als Teil eines Aggregats erstellt wird, geben Sie einen Zeiger auf die steuernde IUnknown-Schnittstelle des Aggregats an.

[in] fUseDefault

Wenn TRUE, verwenden Sie den Standardfilter. wenn FALSE, fahren Sie mit dem am besten geeigneten Filter fort, der verfügbar ist.

[in, out] pFilterClsid

Zeiger auf die CLSID (CLSID_FilterRegistration), die den Klassenbezeichner des zurückgegebenen Filters empfängt.

[in, out] SearchDecSize

Nicht implementiert.

[in, out] pwcsSearchDesc

Nicht implementiert.

[in, out] ppIFilt

Die Adresse eines Zeigers auf eine Implementierung einer von LoadIFilter ausgewählten IFilter-Schnittstelle.

Rückgabewert

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

Hinweise

Ein Filter, auch als Filterhandler bezeichnet, ist eine Implementierung der IFilter-Schnittstelle .

ILoadFilter versucht, einen Filter zu laden, der eine Shell-Datenquelle des im pFilteredSources-Parameter angegebenen Typs über den pwcsPath-Parameter verarbeiten kann. Wenn kein geeigneter Filter für die Datenquelle gefunden wird und fUseDefaultfalse ist, gibt diese Methode null im ppIFilt-Parameter zurück. Wenn kein geeigneter Filter für die Datenquelle gefunden wird und fUseDefaulttrue ist, wird die IFilter-Schnittstelle im Standard-IFilter im ppIFilt-Parameter zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	filtereg.h
Bibliothek	SearchSDK.lib (für CLSID_FilterRegistration)

Weitere Informationen

ILoadFilter