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

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 retornado

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 especificado 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 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 e Processos. Para obter detalhes sobre eventos de monitoramento, consulte Eventos de Monitoramento.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (include Dbgeng.h)