Método IDebugSystemObjects3::SetCurrentProcessId (dbgeng.h)

Artigo
02/06/2025

O método SetCurrentProcessId torna o processo especificado o processo atual.

Sintaxe

HRESULT SetCurrentProcessId(
  [in] ULONG Id
);

Parâmetros

[in] Id

Especifica a ID do processo do mecanismo para o processo que deve se tornar o processo atual.

Valor de retorno

Esse método também pode retornar outros valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_NOINTERFACE	Nenhum processo com a ID do processo especificado foi encontrado.
E_FAIL	Não foi possível encontrar nenhum candidato adequado para o thread atual no processo.

Observações

Esse método também altera o thread atual e pode alterar o destino atual e o computador atual.

Se o processo for alterado, o retorno de chamada IDebugEventCallbacks::ChangeEngineState será chamado com o conjunto de bits DEBUG_CES_CURRENT_THREAD.

Observação Na depuração no modo kernel, o processo atual é um processo virtual, não é um processo do sistema. Esse método não pode ser usado para alterar os processos do sistema na depuração no modo kernel. No entanto, o processo implícito pode ser alterado usando SetImplicitProcessDataOffset.

Para obter mais informações sobre processos, consulte Threads and Processes. Para obter detalhes sobre eventos de monitoramento, consulte Eventos de Monitoramento.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Compartilhar via