Partager via

SnapshotOnDemand

  • Article

Prend une fois instantané pour le SnapshotType donné pour les processus spécifiés, puis exporte vers les mémoires tampons de trace. Le instantané doit être configuré avant d’appeler cette API.

Syntaxe

HRESULT SnapshotOnDemand
([in] SnapshotType snapshotType,
[in] ULONG* pids,
[in] ULONG cPids);

Paramètres

snapshotType
[in] SnapshotType.
Remarque : Actuellement, seul snapshotType disponible est SnapshotType_Heap.
Pids
[in] Pointeur vers un tableau d’ID de processus. Jusqu’à 8 ID de processus peuvent être spécifiés.
cPids
[in] Nombre d’ID de processus dans le tableau. Le nombre maximal est 8.

Valeur de retour

Le tableau suivant décrit les valeurs de retour possibles.

Valeur de retour Description
S_OK La instantané est correctement prise pour les processus spécifiés.
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS Le nombre de PID a dépassé la limite maximale autorisée. Jusqu’à 8 pids peuvent être spécifiés.