Metodo ISearchCrawlScopeManager2::GetVersion (searchapi.h)

Articolo
03/01/2024

Causa il mapping dei file nello spazio degli indirizzi del processo chiamante e informa i client se lo stato di Gestione ambiti di ricerca per indicizzazione (CSM) è cambiato.

Sintassi

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

Parametri

[out] plVersion

Tipo: LONG**

Riceve un puntatore all'indirizzo di un file mappato alla memoria contenente la versione dell'ambito di ricerca per indicizzazione.

[out] phFileMapping

Tipo: HANDLE*

Riceve un puntatore all'handle dell'oggetto di mapping dei file, con accesso di sola lettura, usato per creare il file mappato alla memoria contenente la versione dell'ambito di ricerca per indicizzazione.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il numero di versione recuperato è sempre corrente e cambia lo stato del CSM, ad esempio le aggiunte o le rimozione nell'ambito della ricerca per indicizzazione. Pertanto, ISearchCrawlScopeManager2::GetVersion deve essere chiamato una sola volta, perché la versione corrente rimane sempre disponibile tramite il puntatore recuperato.

ISearchCrawlScopeManager2::GetVersion non genera una chiamata tra processi. Se il metodo ha esito positivo, il client deve eseguire le azioni seguenti per eliminare tutte le visualizzazioni file nello spazio indirizzi e quindi chiudere l'handle dell'oggetto di mapping dei file e il file su disco:

Chiamare UnmapViewOfFile usando il puntatore del file mappato alla memoria fornito da plVersion
Chiamare CloseHandle usando l'handle dell'oggetto di mapping dei file

Il client deve eseguire questi passaggi al termine dell'uso del file mappato alla memoria, per evitare perdite di memoria.

Windows 7 e versioni successive: vedere l'esempio di codice CrawlScopeCommandLine per vedere come definire le opzioni della riga di comando per le operazioni di indicizzazione di Gestione ambiti di ricerca per indicizzazione .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	searchapi.h

Condividi tramite