共用方式為


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

另請參閱

IFilter