Arrêter

Arrête un enregistrement en mode journalisation de fichiers.

Syntaxe

HRESULT Stop
  ([in] BSTR bstrFileName,
  [in] IProfileCollection* pProfileCollection,
  [in] ITraceMergeProperties* pTraceMergeProperties)
;

Paramètres

bstrFileName
[in] Nom du fichier dans lequel les événements fusionnés à partir des enregistrements de tous les profils sont enregistrés.

pProfileCollection
[in] Pointeur vers un objet IProfileCollection qui contient une collection de profils à enregistrer.

pTraceMergeProperties
[in] Pointeur vers un objet ITraceMergeProperties qui contient des propriétés avec lesquelles fusionner des enregistrements.

Valeur de retour

Le tableau suivant décrit les valeurs de retour possibles.

Valeur de retour Description

S_OK

La fonction a correctement arrêté l’enregistrement.

E_INVALIDARG

Un ou plusieurs arguments ne sont pas valides.

E_WPRC_FAILED_TO_STOP_PROFILE

La bibliothèque n’a pas pu arrêter un profil dans la collection de profils. Utilisez IControlErrorInfo pour obtenir des informations détaillées sur les erreurs.

E_WPRC_TRACE_MERGE_LOST_EVENTS

Les événements perdus de la session Suivi des événements pour Windows (ETW) et la fusion des fichiers journaux de trace d’événements (ETL) de la session peut créer un fichier ETL incomplet.

Notes

Utilisez cette fonction uniquement pour les profils qui sont connectés séquentiellement à un fichier. Une fois les sessions enregistrées, l’enregistrement s’arrête.

IControlManager