UpdateHeapTrace

Cette fonction met à jour une session de suivi de tas existante avec un nouvel ensemble de PID, d’événements stackwalking ou d’autres modifications de session ETW.

ULONG
WINAPI
UpdateHeapTrace(
    _Inout_ PEVENT_TRACE_PROPERTIES Properties,
    _In_z_ LPCWSTR wszSessionName,
    _In_reads_opt_(cPids) const ULONG Pids[],
    _In_  ULONG cPids,
    _In_reads_opt_(cStackTracingEventIds) const STACK_TRACING_EVENT_ID StackTracingEventIds[],
    _In_  ULONG cStackTracingEventIds
    );

Paramètres

TraceHandle [out]
Stocke un handle dans une session de suivi d’événements. Ce paramètre est défini sur zéro si le handle n’est pas valide. Ce paramètre ne doit pas être comparé à INVALID_HANDLE_VALUE. N’utilisez pas ce handle en cas d’échec de la fonction.

Propriétés [in, out]
Pointeur vers une structure EVENT_TRACE_PROPERTIES avec des propriétés mises à jour pour la session. Pour plus d’informations sur les membres de cette structure qui peuvent être spécifiés, reportez-vous à la fonction ControlTrace avec ControlCode EVENT_TRACE_CONTROL_UPDATE.

wszSessionName[in]
Nom de la session de suivi de tas à mettre à jour. Il doit s’agir du même nom que celui qui a été passé à StartHeapTrace.

Pids [in]
Tableau d’ID de processus sur lequel activer le suivi de tas.

cPids [in, out]
Taille du tableau Pids.

StackTracingEventIds [in]
Tableau de structures STACK_TRACING_EVENT_ID spécifiant pour quelle marche de pile d’événements de tas doit être activée. Sa valeur peut être NULL.

cStackTracingEventIds [in]
Taille du tableau StackTracingEventIds.

Valeur de retour

ERROR_SUCCESS indique la réussite.

Les valeurs d’erreur possibles sont décrites dans le tableau suivant.

Valeur d’erreur	Description
ERROR_ALREADY_EXISTS	Une seule instance de l’enregistreur d’événements du noyau s’exécute sur le système. Si cette fonction tente de démarrer après qu’un autre composant a démarré la journalisation du noyau, cette erreur est peut-être retournée.
ERROR_INVALID_FLAGS	Indique éventuellement qu’il existe des indicateurs de trace non valides dans Properties.EnableFlags.
ERROR_OUT_OF_MEMORY	Indique éventuellement un échec d’allocation de mémoire pour EVENT_TRACE_PROPERTIES.

Si la fonction échoue pour une raison autre que celle répertoriée, un code d’erreur système est retourné.

Notes

None

Rubriques connexes

Fonctions

StartHeapTrace