Metodo ISearchCrawlScopeManager2::GetVersion (searchapi.h)

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

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