IFilter：：GetChunk 方法 (filter.h)

  • 發行項

注意

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

將篩選置於下一個區塊的開頭，如果這是 GetChunk 方法的第一個呼叫，則位於第一個區塊，並傳回目前區塊的描述。

語法

SCODE GetChunk(
  [out] STAT_CHUNK *pStat
);

參數

[out] pStat

包含目前區塊描述 之STAT_CHUNK 結構的指標。

傳回值

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

傳回碼 描述
S_OK
 作業已順利完成。
FILTER_E_END_OF_CHUNKS
 上一個區塊是最後一個區塊。
FILTER_E_EMBEDDING_UNAVAILABLE
 下一個區塊是內嵌，而且沒有可用的內容篩選。
FILTER_E_LINK_UNAVAILABLE
 下一個區塊是連結，而且沒有可用的內容篩選。
FILTER_E_PASSWORD
 密碼或其他安全性相關的存取失敗。
FILTER_E_ACCESS
一般存取失敗。

備註

如果傳回pStat時指向STAT_CHUNK結構，且 breakType成員等於CHUNK_NO_BREAK，則只有idChunk成員會以新的區塊識別碼更新， (識別碼) 值。 STAT_CHUNK結構的其他成員保持不變。

內部實數值型別屬性 (區塊，而 區塊的 CHUNKSTATE 列舉值為 CHUNK_VALUE) 無法使用 CHUNK_NO_BREAK串連。 單字不能跨越兩個以上的黏附區塊。

區塊識別碼零無效。

第一次呼叫 GetChunk 方法之前，沒有目前的區塊。 在錯誤傳回FILTER_E_END_OF_CHUNKS GetChunk 方法的下一個呼叫之後，仍會在無法使用的區塊之後擷取下一個區塊。

來電者的附注

GetChunk方法完成時，*pStat中所述的區塊是目前的區塊。 區塊描述元是由呼叫 GetChunk 方法的常式所擁有，但是可在屬性規格中設定的屬性名稱指標是由 GetChunk 方法所擁有，因此不應該釋放。

實作者的注意事項

如果呼叫連結或内嵌物件之內容篩選的 GetChunk 方法會傳回FILTER_E_END_OF_CHUNKS，則實作應該會傳回連結或内嵌物件的下一個區塊。 例如，如果檔有兩個内嵌物件，而第一個已傳回FILTER_E_END_OF_CHUNKS，則外部內容篩選準則必須呼叫内嵌物件之內容篩選的 GetChunk 方法。

在內嵌或連結化物件上傳回 GetChunk 方法呼叫的結果之前，請檢查以確定區塊識別碼是唯一的。 如果沒有，實作者必須重新編號區塊，並保留新區塊識別碼的對應。

需求

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

另請參閱

IFilter

STAT_CHUNK