IFilter::Init 方法 (filter.h)
初始化篩選會話。
語法
SCODE Init(
[in] ULONG grfFlags,
[in] ULONG cAttributes,
[in] const FULLPROPSPEC *aAttributes,
[out] ULONG *pFlags
);
參數
[in] grfFlags
來自 IFILTER_INIT 列舉的值,用於控制文字標準化、屬性輸出、內嵌範圍,以及 IFilter 存取模式。
[in] cAttributes
屬性陣列的大小。 當非零時,cAttributes 優先於 grfFlags中指定的屬性。 如果未指定任何屬性旗標,且 cAttributes 為零,則預設會由PSGUID_STORAGE storage 屬性集指定,其中包含上次寫入檔案的日期和時間、大小等等:和 by the PID_STG_CONTENTS 'contents' 屬性,它會對應至檔案的主要內容。 如需屬性和屬性集的詳細資訊,請參閱 屬性集。
[in] aAttributes
所要求屬性之 FULLPROPSPEC 結構的陣列指標。 當 cAttributes 為非零時,只會傳回 aAttributes 中的屬性。
[out] pFlags
呼叫端可用的其他屬性相關信息;從 IFILTER_FLAGS 列舉。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
作業已順利完成。 |
|
先前未載入要篩選的檔案。 |
|
屬性的計數和內容不同意。 |
|
因為密碼保護或類似的安全性措施,因此拒絕存取。 |
|
一般存取失敗 |
言論
Init 方法會設定篩選物件的狀態。 內容篩選條件會位於物件的開頭,而且對象狀態會凍結,直到釋放對象為止。 您可以在 aAttributes 陣列中設定其屬性集和屬性識別碼 (ID) 描述,以傳遞您想要傳回的屬性集篩選物件。 如需詳細資訊,請參閱 篩選檔案屬性。
給來電者的附註
先呼叫 Init 方法,再呼叫所有其他 IFilter 方法。實作者的注意事項
區塊標識碼在多個呼叫 init 方法時必須保持一致,且參數相同。對於 IFilter 介面的某些實作,在呼叫 Init 方法之前,可能無法偵測無法存取檔(或可能計算成本高昂)。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | filter.h |