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