IFilter：：GetValue 方法 (filter.h)

注意

從 Windows XP 開始，不再支援編制索引服務，而且無法從 Windows 8 開始使用。請改用 Windows 搜尋進行用戶端搜尋，並使用 Microsoft Search Server Express 進行伺服器端搜尋。

從區塊擷取值 (內部實數值型別屬性) ，其必須具有 CHUNK_VALUE的 CHUNKSTATE 列舉值。

語法

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

[out] ppPropValue

輸出變數的指標，接收包含實值型別屬性之 PROPVARIANT 結構的指標。

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	作業已順利完成。
FILTER_E_NO_MORE_VALUES	已在此區塊上呼叫 GetValue 方法;此值應該會傳回，直到成功呼叫 IFilter：：GetChunk 方法，且已前進到下一個區塊為止。
FILTER_E_NO_VALUES	目前的區塊沒有 CHUNK_VALUE的 CHUNKSTATE 列舉值。

每個區塊只呼叫 GetValue 方法一次。

請注意，從多個區塊產生相同值的效果是未定義的。只有值的最後一個設定有效。

使用CoTaskMemAlloc配置PROPVARIANT結構。某些 PROPVARIANT 結構包含指標，可藉由呼叫 PropVariantClear 函式來釋放。由 GetValue 方法呼叫 PropVariantClear的呼叫端決定。


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	filter.h