Método IDebugEventCallbacks::CreateProcess (dbgeng.h)

Artigo
02/06/2025

O método de retorno de chamada CreateProcess é chamado pelo mecanismo quando ocorre um evento de depuração de processo de criação no destino.

Sintaxe

HRESULT CreateProcess(
  [in]           ULONG64 ImageFileHandle,
  [in]           ULONG64 Handle,
  [in]           ULONG64 BaseOffset,
  [in]           ULONG   ModuleSize,
  [in, optional] PCSTR   ModuleName,
  [in, optional] PCSTR   ImageName,
  [in]           ULONG   CheckSum,
  [in]           ULONG   TimeDateStamp,
  [in]           ULONG64 InitialThreadHandle,
  [in]           ULONG64 ThreadDataOffset,
  [in]           ULONG64 StartOffset
);

Parâmetros

[in] ImageFileHandle

Especifica o identificador para o arquivo de imagem do processo. Se essas informações não estiverem disponíveis, ImageFileHandle será NULL.

[in] Handle

Especifica o identificador do processo. Esse parâmetro corresponde ao campo hProcess na estrutura CREATE_PROCESS_DEBUG_INFO. Se essas informações não estiverem disponíveis, ImageFileHandle será NULL.

[in] BaseOffset

Especifica o endereço base da imagem executável do processo no espaço de endereço de memória do destino. Se essas informações não estiverem disponíveis, BaseOffset será NULL.

[in] ModuleSize

Especifica o tamanho da imagem executável do processo em bytes. Se essas informações não estiverem disponíveis, ModuleSize será zero.

[in, optional] ModuleName

Especifica o nome do módulo simplificado que é usado pelo mecanismo de depurador. Na maioria dos casos, isso corresponde ao nome do arquivo de imagem, excluindo a extensão. Se essas informações não estiverem disponíveis, ModuleName será NULL.

[in, optional] ImageName

Especifica o nome do arquivo de imagem executável do processo, que pode incluir o caminho. Se essas informações não estiverem disponíveis, ImageName será NULL.

[in] CheckSum

Especifica a soma de verificação da imagem executável do processo. Se essas informações não estiverem disponíveis, CheckSum será zero.

[in] TimeDateStamp

Especifica o carimbo de data e hora do arquivo de imagem executável do processo. Se essas informações não estiverem disponíveis, TimeDateStamp será zero.

[in] InitialThreadHandle

Especifica o identificador para o thread inicial do processo. Esse parâmetro corresponde ao campo hThread na estrutura CREATE_PROCESS_DEBUG_INFO. Se essas informações não estiverem disponíveis, InitialThreadHandle será NULL.

[in] ThreadDataOffset

Especifica um bloco de dados que o sistema operacional mantém para esse thread. Os dados reais no bloco são específicos do sistema operacional. Se essas informações não estiverem disponíveis, ThreadDataOffset será NULL.

[in] StartOffset

Especifica o endereço inicial do thread no espaço de endereço virtual do processo. Se essas informações não estiverem disponíveis, StartOffset será NULL.

Valor de retorno

Esse método retorna um valor DEBUG_STATUS_XXX, que indica como a execução do destino deve continuar depois que o mecanismo processa esse evento. Para obter detalhes sobre como o mecanismo trata esse valor, consulte Eventos de Monitoramento.

Observações

Esse método só será chamado pelo mecanismo se o sinalizador DEBUG_EVENT_CREATE_PROCESS estiver definido na máscara retornada por IDebugEventCallbacks::GetInterestMask.

Para obter mais informações sobre como lidar com eventos, consulte Eventos de Monitoramento. Para obter informações sobre threads, consulte Threads and Processes.

Requisitos

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

Compartilhar via