共用方式為

IFilter：：Init 方法 (filter.h)

  • 發行項

注意

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

初始化篩選會話。

語法

SCODE Init(
  [in]  ULONG              grfFlags,
  [in]  ULONG              cAttributes,
  [in]  const FULLPROPSPEC *aAttributes,
  [out] ULONG              *pFlags
);

參數

[in] grfFlags

用於控制文字標準化、屬性輸出、內嵌範圍和 IFilter 存取模式之IFILTER_INIT列舉的值。

[in] cAttributes

屬性陣列的大小。 當非零時， cAttributes 會優先於 grfFlags 中指定的屬性。 如果未指定任何屬性旗標， 且 cAttributes 為零，則預設是由PSGUID_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 陣列中設定其屬性集和屬性識別碼 (識別元) 描述，將篩選對象傳遞給您想要傳回的屬性集。 如需詳細資訊，請參閱 篩選檔案屬性。

來電者附註

呼叫所有其他 IFilter 方法之前，請先呼叫 Init 方法。

實作者的注意事項

區塊標識碼在對 Init 方法的多個呼叫之間必須保持一致，且具有相同參數。

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

規格需求

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

另請參閱

FULLPROPSPEC

IFILTER_FLAGS

IFILTER_INIT

IFilter