Condividi tramite

UpdateHeapTrace

  • Articolo

Questa funzione aggiorna una sessione di traccia heap esistente con un nuovo set di ID PID, eventistacki o altre modifiche di sessione 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
    );

Parametri

TraceHandle [out]
Archivia un handle in una sessione di traccia eventi. Questo parametro è impostato su zero se l'handle non è valido. Questo parametro non deve essere confrontato con INVALID_HANDLE_VALUE. Non usare questo handle se la funzione ha esito negativo.

Proprietà [in, out]
Puntatore a una struttura EVENT_TRACE_PROPERTIES con proprietà aggiornate per la sessione. Per informazioni dettagliate sui membri di questa struttura, vedere la funzione ControlTrace con ControlCode EVENT_TRACE_CONTROL_UPDATE.

wszSessionName[in]
Nome della sessione di traccia heap da aggiornare. Questo deve essere lo stesso nome passato a StartHeapTrace.

Pids [in]
Matrice di ID processo su cui abilitare la traccia heap.

cPids [in, out]
Dimensione della matrice Pids.

StackTracingEventIds [in]
Matrice di strutture STACK_TRACING_EVENT_ID che specificano quale stack di eventi heap deve essere abilitato. Può essere NULL.

cStackTracingEventIds [in]
Dimensioni della matrice StackTracingEventIds.

Valore restituito

ERROR_SUCCESS indica l'esito positivo.

I valori di errore possibili sono descritti nella tabella seguente.

Valore errore Descrizione

ERROR_ALREADY_EXISTS

Solo una singola istanza del logger kernel viene eseguita nel sistema. Se questa funzione tenta di iniziare dopo che un altro componente ha avviato la registrazione del kernel, questo errore potrebbe essere restituito.

ERROR_INVALID_FLAGS

Possibilmente indica che esistono flag di traccia non validi in Proprietà.EnableFlags.

ERROR_OUT_OF_MEMORY

Probabilmente indica l'errore di allocare memoria per EVENT_TRACE_PROPERTIES.

Se la funzione ha esito negativo per un motivo diverso da quelli elencati, viene restituito un codice di errore di sistema.

Osservazioni

nessuno

Funzioni

StartHeapTrace