ConfigSnapshotByPID
Configura instantâneo usando a ID do processo fornecida.
Sintaxe
HRESULT ConfigSnapshotByPID
([in, out] ULONG* pids,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
Parâmetros
Pids
[in] O ponteiro para uma matriz de IDs de processo.
cPids
[in] O número de IDs de processo na matriz.
fEnable
[in] Um valor booliano que indica se o instantâneo deve ser habilitado ou desabilitado.
Valor Retornado
A tabela a seguir descreve possíveis valores retornados.
| Valor Retornado | Descrição |
|---|---|
| S_OK | A configuração foi bem-sucedida para os processos especificados. |
| S_FALSE | A configuração foi parcialmente bem-sucedida. Consulte pResults para investigar mais detalhadamente qual processo falhou. |
| E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS | Falha ao configurar o controle de pilha de heap de PIDs. |
Comentários
Quando a função retorna uma falha parcial (S_FALSE), isso significa que nem todos os processos na matriz de ID do processo são configurados com êxito. Para localizar qual processo(es) falhou, use a função ConfigSnapshotByPIDEx .
A configuração instantâneo é válida até que seja desabilitada explicitamente ou o processo seja encerrado.