共用方式為


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 列舉。

傳回值

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

傳回碼 描述
S_OK
作業已順利完成。
E_FAIL
先前未載入要篩選的檔案。
E_INVALIDARG
屬性的計數和內容不同意。
FILTER_E_PASSWORD
因為密碼保護或類似的安全性措施,因此拒絕存取。
FILTER_E_ACCESS
一般存取失敗

言論

Init 方法會設定篩選物件的狀態。 內容篩選條件會位於物件的開頭,而且對象狀態會凍結,直到釋放對象為止。 您可以在 aAttributes 陣列中設定其屬性集和屬性識別碼 (ID) 描述,以傳遞您想要傳回的屬性集篩選物件。 如需詳細資訊,請參閱 篩選檔案屬性

給來電者的附註

先呼叫 Init 方法,再呼叫所有其他 IFilter 方法。

實作者的注意事項

區塊標識碼在多個呼叫 init 方法時必須保持一致,且參數相同。

對於 IFilter 介面的某些實作,在呼叫 Init 方法之前,可能無法偵測無法存取檔(或可能計算成本高昂)。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 filter.h

另請參閱

FULLPROPSPEC

IFILTER_FLAGS

IFILTER_INIT

IFilter