Metode ISearchCrawlScopeManager2::GetVersion (searchapi.h)

Artikel
08/25/2023

Menyebabkan pemetaan file dipetakan ke ruang alamat proses panggilan, dan memberi tahu klien jika status Crawl Scope Manager (CSM) telah berubah.

Sintaks

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

Parameter

[out] plVersion

Jenis: LONG**

Menerima penunjuk ke alamat file yang dipetakan memori yang berisi versi cakupan perayapan.

[out] phFileMapping

Jenis: HANDLE*

Menerima penunjuk ke handel objek pemetaan file, dengan akses baca-saja, yang digunakan untuk membuat file yang dipetakan memori yang berisi versi cakupan perayapan.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Nomor versi yang diambil selalu terkini, dan berubah sebagai status CSM, seperti apakah penambahan atau penghapusan dilakukan pada cakupan perayapan, misalnya. Oleh karena itu, ISearchCrawlScopeManager2::GetVersion hanya perlu dipanggil sekali, karena versi saat ini selalu tersedia melalui pointer yang diambil.

ISearchCrawlScopeManager2::GetVersion tidak menghasilkan panggilan lintas proses. Jika metode berhasil, maka klien harus melakukan tindakan berikut untuk menghancurkan semua tampilan file di ruang alamatnya, lalu menutup handel objek pemetaan file dan file pada disk:

Panggil UnmapViewOfFile menggunakan penunjuk file yang dipetakan memori yang disediakan oleh plVersion
Panggil CloseHandle menggunakan handel objek pemetaan file

Klien harus melakukan langkah-langkah ini setelah selesai menggunakan file yang dipetakan memori, untuk mencegah kebocoran memori.

Windows 7 dan yang lebih baru: Lihat sampel kode CrawlScopeCommandLine untuk melihat cara menentukan opsi baris perintah untuk operasi pengindeksan Crawl Scope Manager (CSM).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	searchapi.h

Bagikan melalui