Partilhar via

SnapshotOnDemand

  • Artigo

Leva uma vez instantâneo para o SnapshotType fornecido para os processos especificados e exporta para os buffers de rastreamento. O instantâneo precisa ser configurado antes de chamar essa API.

Sintaxe

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

Parâmetros

snapshotType
[in] SnapshotType.
Observação: atualmente, somente SnapshotType disponível está SnapshotType_Heap.
Pids
[in] O ponteiro para uma matriz de IDs de processo. Até 8 IDs de processo podem ser especificadas.
cPids
[in] O número de IDs de processo na matriz. O número máximo é 8.

Valor Retornado

A tabela a seguir descreve possíveis valores retornados.

Valor Retornado Descrição
S_OK O instantâneo é feito com êxito para os processos especificados.
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS O número de PIDs excedeu o limite máximo permitido. Até 8 pids podem ser especificados.