Partager via


Enregistrer

Enregistre un enregistrement enregistré dans des mémoires tampons circulaires dans le fichier de journal de trace des événements (ETL) spécifié. L’enregistrement continue de s’exécuter.

Syntaxe

HRESULT Save
  ([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 l’objet IProfileCollection qui contient une collection de profils à enregistrer.

pTraceMergeProperties
[in] Pointeur vers l’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 enregistré l’enregistrement.

E_INVALIDARG

Un ou plusieurs arguments ne sont pas valides.

E_WPRC_FAILED_TO_SAVE_PROFILE

La bibliothèque n’a pas pu enregistrer 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

Cette fonction est utilisée uniquement pour les profils qui journalisent des mémoires tampons circulaires. Une fois les sessions enregistrées, l’enregistrement continue de s’exécuter.

IControlManager