ConfigSnapshotByPIDEx
Configura instantâneo usando a ID do processo fornecida.
Sintaxe
HRESULT ConfigSnapshotByPIDEx
([in] SnapshotType snapshotType,
[in, out] ULONG* pids,
[in, out] HRESULT* pResults,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
Parâmetros
snapshotType
[in] SnapshotType.
Observação : atualmente, somente SnapshotType disponível é SnapshotType_Heap
Pids
[in] O ponteiro para uma matriz de IDs de processo.
Presults
[in, out] O buffer alocado pelo usuário que conterá o código hresult de configuração instantâneo para cada ID de processo especificada, a matriz passada no segundo parâmetro.
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 pelo menos uma falha parcial (S_FALSE), cada elemento de pResults mostra o resultado da configuração da ID de processo correspondente passada no segundo parâmetro.
Por exemplo, se você passar três pids, a matriz pResults mostrará o resultado da configuração de cada pid, conforme mostrado abaixo.
| Pids [in] | 0x1086 | 0x98004 | 0x12004 |
| pResults [out] | S_OK | E_INVALIDARG | S_OK |
A configuração de instantâneo é válida até que seja explicitamente desabilitada ou o processo seja encerrado.