ISearchCrawlScopeManager2::GetVersion-Methode (searchapi.h)

Artikel
03/01/2024

Bewirkt, dass die Dateizuordnung dem Adressraum des aufrufenden Prozesses zugeordnet wird, und informiert Die Clients, wenn sich der Status des Durchforstungsbereichs-Managers (CSM) geändert hat.

Syntax

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

Parameter

[out] plVersion

Typ: LONG**

Empfängt einen Zeiger auf die Adresse einer Speicherzuordnungsdatei, die die Version des Durchforstungsbereichs enthält.

[out] phFileMapping

Typ: HANDLE*

Empfängt einen Zeiger auf das Handle des Dateizuordnungsobjekts mit schreibgeschütztem Zugriff, das zum Erstellen der zugeordneten Speicherdatei verwendet wurde, die die Durchforstungsbereichsversion enthält.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die abgerufene Versionsnummer ist immer aktuell und ändert sich als Status des CSM, z. B. ob Ergänzungen oder Entfernungen für den Durchforstungsbereich vorgenommen wurden. Daher muss ISearchCrawlScopeManager2::GetVersion nur einmal aufgerufen werden, da die aktuelle Version immer über den abgerufenen Zeiger verfügbar bleibt.

ISearchCrawlScopeManager2::GetVersion führt nicht zu einem prozessübergreifenden Aufruf. Wenn die Methode erfolgreich ist, muss der Client die folgenden Aktionen ausführen, um alle Dateiansichten in seinem Adressraum zu zerstören, und dann das Handle des Dateizuordnungsobjekts und die Datei auf dem Datenträger schließen:

Aufrufen von UnmapViewOfFile mithilfe des Zeigers der von plVersion bereitgestellten Speicherabbilddatei
Aufrufen von CloseHandle mithilfe des Handle des Dateizuordnungsobjekts

Der Client muss diese Schritte ausführen, wenn er die Speicherzuordnungsdatei verwendet, um Speicherverluste zu verhindern.

Windows 7 und höher: Sehen Sie sich das Codebeispiel CrawlScopeCommandLine an, um zu erfahren, wie Befehlszeilenoptionen für CSM-Indizierungsvorgänge (Crawl Scope Manager) definiert werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	searchapi.h

Freigeben über