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