ISearchCrawlScopeManager2 ::GetVersion, méthode (searchapi.h)

Article
03/01/2024

Provoque le mappage de fichiers dans l’espace d’adressage du processus appelant et informe les clients si l’état du Gestionnaire d’étendues d’analyse (CSM) a changé.

Syntaxe

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

Paramètres

[out] plVersion

Type : LONG**

Reçoit un pointeur vers l’adresse d’un fichier mappé en mémoire qui contient la version de l’étendue d’analyse.

[out] phFileMapping

Type : HANDLE*

Reçoit un pointeur vers le handle de l’objet de mappage de fichiers, avec accès en lecture seule, qui a été utilisé pour créer le fichier mappé en mémoire qui contient la version de l’étendue d’analyse.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le numéro de version récupéré est toujours à jour et change en tant qu’état du CSM, par exemple si des ajouts ou des suppressions ont été effectués dans l’étendue d’analyse. Par conséquent, ISearchCrawlScopeManager2 ::GetVersion ne doit être appelé qu’une seule fois, car la version actuelle reste toujours disponible via le pointeur récupéré.

ISearchCrawlScopeManager2 ::GetVersion n’entraîne pas d’appel interprocesseur. Si la méthode réussit, le client doit effectuer les actions suivantes pour détruire toutes les vues de fichiers dans son espace d’adressage, puis fermer le handle de l’objet de mappage de fichiers et le fichier sur le disque :

Appelez UnmapViewOfFile à l’aide du pointeur du fichier mappé en mémoire fourni par plVersion
Appeler CloseHandle à l’aide du handle de l’objet de mappage de fichiers

Le client doit effectuer ces étapes lorsque vous avez terminé d’utiliser le fichier mappé en mémoire pour éviter les fuites de mémoire.

Windows 7 et versions ultérieures : consultez l’exemple de code CrawlScopeCommandLine pour voir comment définir des options de ligne de commande pour les opérations d’indexation du Gestionnaire d’étendues d’analyse (CSM).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	searchapi.h

Partager via