Metodo ILoadFilter::LoadIFilter (filtereg.h)

Recupera e carica il filtro più appropriato mappato a un'origine dati shell.

Sintassi

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
);

Parametri

[in] pwcsPath

Puntatore a un buffer di stringa Unicode con terminazione Null delimitato da virgole che specifica il percorso del file da filtrare. Questo parametro può essere null.

[in] pFilteredSources

Puntatore alla struttura FILTERED_DATA_SOURCES che specifica i parametri per un'origine dati Shell per cui viene caricato un filtro. Questo parametro non può essere null.

[in] pUnkOuter

Se l'oggetto viene creato come parte di un'aggregazione, specificare un puntatore all'interfaccia IUnknown di controllo dell'aggregazione.

[in] fUseDefault

Se TRUE, usare il filtro predefinito; se FALSE, procedere con il filtro più appropriato disponibile.

[in, out] pFilterClsid

Puntatore al CLSID (CLSID_FilterRegistration) che riceve l'identificatore di classe del filtro restituito.

[in, out] SearchDecSize

Non implementato.

[in, out] pwcsSearchDesc

Non implementato.

[in, out] ppIFilt

Indirizzo di un puntatore a un'implementazione di un'interfaccia IFilter selezionata da LoadIFilter .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un filtro, noto anche come gestore di filtri, è un'implementazione dell'interfaccia IFilter .

ILoadFilter tenta di caricare un filtro in grado di elaborare un'origine dati Shell del tipo specificato nel parametro pFilteredSources tramite il parametro pwcsPath . Se non viene trovato un filtro appropriato per l'origine dati e fUseDefault è false, questo metodo restituisce null nel parametro ppIFilt . Se non viene trovato un filtro appropriato per l'origine dati e fUseDefault è true, l'interfaccia IFilter sul filtro IFilter predefinito viene restituita nel parametro ppIFilt .

Requisiti

Vedi anche

ILoadFilter