Compartir a través de

SnapshotOnDemand

  • Artículo

Toma una instantánea de una vez para el snapshotType especificado para los procesos especificados y, a continuación, exporta a los búferes de seguimiento. La instantánea debe configurarse antes de llamar a esta API.

Sintaxis

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

Parámetros

snapshotType
[in] SnapshotType.
Nota: Actualmente solo está disponible SnapshotTypeSnapshotType_Heap.
Pid
[in] Puntero a una matriz de identificadores de proceso. Se pueden especificar hasta 8 identificadores de proceso.
cPids
[in] Número de identificadores de proceso de la matriz. El número máximo es 8.

Valor devuelto

En la tabla siguiente se describen los posibles valores devueltos.

Valor devuelto Descripción
S_OK La instantánea se toma correctamente para los procesos especificados.
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS El número de PID superó el límite máximo permitido. Se pueden especificar hasta 8 pids.