Share via


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

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 para o 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 usado pelo mecanismo do 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 executável-imagem 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 executável-imagem 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.

Retornar valor

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

Comentários

Esse método só será chamado pelo mecanismo se o sinalizador DEBUG_EVENT_CREATE_PROCESS for 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 e Processos.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)