通过

IFilter：：GetValue 方法 (filter.h)

  • 项目

注意

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

从区块中检索 (内部值类型属性) 的值，该区块的 CHUNKSTATE 枚举值必须CHUNK_VALUE。

语法

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

参数

[out] ppPropValue

指向输出变量的指针，该变量接收指向包含 value-type 属性的 PROPVARIANT 结构的指针。

返回值

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

返回代码 说明
S_OK
 操作已成功完成。
FILTER_E_NO_MORE_VALUES
已对此区块调用 GetValue 方法;应返回此值，直到成功调用 IFilter：：GetChunk 方法并前进到下一个区块。
FILTER_E_NO_VALUES
 当前区块没有 CHUNKSTATE 枚举值CHUNK_VALUE。

备注

每个区块仅调用 GetValue 方法一次。

请注意，从多个区块生成相同值的效果是不确定的。 只有值的最后一个设置有效。

调用方备注

使用 CoTaskMemAlloc 分配 PROPVARIANT 结构。 某些 PROPVARIANT 结构包含指针，可以通过调用 PropVariantClear 函数来释放这些指针。 由 GetValue 方法的调用方来调用 PropVariantClear。

要求

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

请参阅

IFilter