共用方式為


ISearchCrawlScopeManager2::GetVersion 方法 (searchapi.h)

會導致檔案對應對應到呼叫程式的位址空間,並在編目範圍管理員的狀態 (CSM) 變更時通知用戶端。

語法

HRESULT GetVersion(
  [out] long   **plVersion,
  [out] HANDLE *phFileMapping
);

參數

[out] plVersion

類型: LONG**

接收記憶體對應檔案位址的指標,其中包含編目範圍版本。

[out] phFileMapping

類型: HANDLE*

接收檔案對應物件的句柄指標,其中包含唯讀存取權,用來建立包含編目範圍版本的記憶體對應檔案。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

擷取的版本號碼一律為最新狀態,並變更為CSM的狀態,例如新增或移除編目範圍,例如。 因此, ISearchCrawlScopeManager2::GetVersion 只需要呼叫一次,因為目前的版本一律會透過擷取的指標維持可用狀態。

ISearchCrawlScopeManager2::GetVersion 不會產生跨進程呼叫。 如果方法成功,則客戶端必須執行下列動作來終結其位址空間中的所有檔案檢視,然後關閉檔案對應物件的句柄和磁碟上的檔案:

  • 使用 plVersion 所提供的記憶體對應檔案指標呼叫 UnmapViewOfFile
  • 使用檔案對應物件的句柄呼叫 CloseHandle
用戶端在使用記憶體對應檔案完成時必須執行這些步驟,以防止記憶體流失。

Windows 7 和更新版本:查看 CrawlScopeCommandLine 程式代碼範例 ,瞭解如何定義編目範圍管理員的命令行選項, (CSM) 編製索引作業。

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 searchapi.h