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.