IFilter：：Init 方法 (filter.h)

2024-02-28

注意

从 Windows XP 开始，索引服务不再受支持，并且自 Windows 8 起不可用。请改用 Windows 搜索进行客户端搜索，使用 Microsoft Search Server Express 进行服务器端搜索。

初始化筛选会话。

语法

SCODE Init(
  [in]  ULONG              grfFlags,
  [in]  ULONG              cAttributes,
  [in]  const FULLPROPSPEC *aAttributes,
  [out] ULONG              *pFlags
);

参数

[in] grfFlags

IFILTER_INIT枚举中的值，用于控制文本标准化、属性输出、嵌入范围和 IFilter 访问模式。

[in] cAttributes

属性数组的大小。当非零值时， cAttributes 优先于 grfFlags 中指定的属性。如果未指定属性标志且 cAttributes 为零，则默认由 PSGUID_STORAGE 存储属性集提供，该属性集包含上次写入文件的日期和时间、大小等;和，PID_STG_CONTENTS“contents”属性，该属性映射到文件的main内容。有关属性和属性集的详细信息，请参阅属性集。

[in] aAttributes

指向所请求属性的 FULLPROPSPEC 结构数组的指针。当 cAttributes 不为零时，仅返回 aAttributes 中的属性。

[out] pFlags

有关调用方可用的其他属性的信息;来自 IFILTER_FLAGS 枚举。

返回值

此方法可以返回其中一个值。

返回代码	说明
S_OK	操作已成功完成。
E_FAIL	以前未加载要筛选的文件。
E_INVALIDARG	属性的计数和内容不一致。
FILTER_E_PASSWORD	由于密码保护或类似安全措施，访问被拒绝。
FILTER_E_ACCESS	常规访问失败

注解

Init 方法设置筛选器对象的状态。内容筛选器位于对象开头，对象状态处于冻结状态，直到释放对象。可以通过在 aAttributes 数组中设置属性集和属性标识符 (ID) 说明，向筛选器对象传递希望返回的属性集。有关详细信息，请参阅筛选文件属性。

调用方备注

在调用所有其他 IFilter 方法之前调用 Init 方法。

实施者说明

在对具有相同参数的 Init 方法的多个调用中，区块 ID 必须保持一致。

对于 IFilter 接口的某些实现，在调用 Init 方法之前，在调用 Init 方法之前，可能无法 (检测访问文档的失败，或者可能) 计算成本高昂。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	filter.h