Método ILoadFilter::LoadIFilter (filtereg.h)
Recupera y carga el filtro más adecuado que se asigna a un origen de datos de Shell.
Sintaxis
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
);
Parámetros
[in] pwcsPath
Puntero a un búfer de cadena Unicode delimitado por comas delimitado por comas que especifica la ruta de acceso del archivo que se va a filtrar. Este parámetro puede ser NULL.
[in] pFilteredSources
Puntero a la estructura FILTERED_DATA_SOURCES que especifica parámetros para un origen de datos de Shell para el que se carga un filtro. Este parámetro no puede ser null.
[in] pUnkOuter
Si el objeto se crea como parte de un agregado, especifique un puntero a la interfaz IUnknown de control del agregado.
[in] fUseDefault
Si es TRUE, use el filtro predeterminado; si es FALSE, continúe con el filtro más adecuado que esté disponible.
[in, out] pFilterClsid
Puntero al CLSID (CLSID_FilterRegistration) que recibe el identificador de clase del filtro devuelto.
[in, out] SearchDecSize
Sin implementar.
[in, out] pwcsSearchDesc
Sin implementar.
[in, out] ppIFilt
Dirección de un puntero a una implementación de una interfaz IFilter que LoadIFilter selecciona.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Un filtro, también conocido como controlador de filtros, es una implementación de la interfaz IFilter .
ILoadFilter intenta cargar un filtro que puede procesar un origen de datos de Shell del tipo especificado en el parámetro pFilteredSources a través del parámetro pwcsPath . Si no se encuentra un filtro adecuado para el origen de datos y fUseDefault es false, este método devuelve null en el parámetro ppIFilt . Si no se encuentra un filtro adecuado para el origen de datos y fUseDefault es true, la interfaz IFilter del IFilter predeterminado se devuelve en el parámetro ppIFilt .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | filtereg.h |
| Library | SearchSDK.lib (para CLSID_FilterRegistration) |