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

  • Artigo

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.

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte 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 fornecido foi encontrado.
E_FAIL
 Não foi possível encontrar nenhum candidato adequado para o thread atual no processo.

Comentários

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.

Nota Na depuração do modo kernel, o processo atual é um processo virtual, não é um processo do sistema. Esse método não pode ser usado para alterar entre 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
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)