Metodo IProtocolHandlerSite::GetFilter (searchapi.h)

Recupera il filtro IFilter appropriato in base ai parametri specificati.

Sintassi

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

Parametri

[in] pclsidObj

Tipo: CLSID*

Puntatore al CLSID del tipo di documento dal Registro di sistema. Viene utilizzato per gli elementi con documenti incorporati per indicare il filtro IFilter appropriato da utilizzare per il documento incorporato.

[in] pcwszContentType

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione Null contenente il tipo del documento. Viene usato per recuperare i filtri IFilter mappati in base al tipo MIME.

[in] pcwszExtension

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione Null che contiene l'estensione del nome file, senza il punto precedente. Viene utilizzato per recuperare gli oggetti IFilter mappati in base all'estensione del nome file.

[out] ppFilter

Tipo: IFilter**

Riceve l'indirizzo di un puntatore al filtro IFilter utilizzato dal gestore del protocollo.

Valore restituito

Tipo: HRESULT

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

Commenti

Questo metodo esegue una query sull'host filtro per identificare l'oggetto IFilter appropriato da utilizzare per l'elemento URL.

La scelta del filtro è basata sull'estensione del nome file, un CLSID che identifica il tipo di contenuto del file nel Registro di sistema o il tipo di contenuto MIME. È necessario specificare solo uno dei tre parametri per questo metodo. Se si specificano più parametri, vengono testati nell'ordine seguente: pcwszContentType, pclsidObj, pcwszExtension. Il primo parametro valido viene usato per selezionare il filtro IFilter appropriato; gli altri vengono ignorati.

Requisiti