Méthode IDataCollectorSet ::Start (pla.h)
Démarre manuellement le jeu de collecteurs de données.
Syntaxe
HRESULT Start(
[in] VARIANT_BOOL Synchronous
);
Paramètres
[in] Synchronous
La collecte de données s’exécute dans un processus distinct. Cette valeur détermine quand la méthode retourne.
Définissez sur VARIANT_TRUE pour que la méthode soit retournée après le démarrage ou l’échec du processus de collecte de données. La valeur de retour indique si le jeu a démarré avec succès ou si le démarrage a échoué.
Définissez sur VARIANT_FALSE à retourner une fois que l’ensemble est mis en file d’attente pour s’exécuter. La valeur de retour indique si le jeu a été correctement mis en file d’attente. Pour plus d'informations, consultez la section Notes.
Valeur retournée
Retourne S_OK en cas de réussite. Le tableau suivant présente les valeurs d’erreur possibles.
| Code de retour | Description |
|---|---|
|
Le jeu doit être conservé (voir la méthode Commit ) avant de commencer la collection. |
|
Le système ne peut pas trouver le chemin spécifié. Cette erreur se produit lorsque la propriété RootPath spécifie un répertoire qui n’existe pas. |
|
Le sous-répertoire ou fichier journal existe déjà. Essayez d’utiliser un format pour identifier le fichier de manière unique. |
Remarques
Pour déterminer le status de la collection, accédez à la propriété IDataCollectorSet ::Status.
Une fois le processus de collecte terminé, PLA exécute le gestionnaire de données, s’il est activé.
Pour démarrer automatiquement la collecte de données selon une planification, consultez IDataCollectorSet ::Schedules.
Si vous démarrez le jeu de manière asynchrone, un événement est écrit dans le journal des événements Microsoft-Windows-Diagnosis-PLA/Operational pour indiquer si le processus de collecte a démarré (événement 1003) ou a échoué (événement 1004).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | pla.h |
| DLL | Pla.dll |