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 |