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

El motor llama al método de devolución de llamada CreateProcess cuando se produce un evento de depuración de proceso de creación en el destino.

Sintaxis

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 el identificador del archivo de imagen del proceso. Si esta información no está disponible, ImageFileHandle se null.

[in] Handle

Especifica el identificador del proceso. Este parámetro corresponde al campo hProcess de la estructura CREATE_PROCESS_DEBUG_INFO. Si esta información no está disponible, ImageFileHandle se null.

[in] BaseOffset

Especifica la dirección base de la imagen ejecutable del proceso en el espacio de direcciones de memoria del destino. Si esta información no está disponible, BaseOffset se NULL.

[in] ModuleSize

Especifica el tamaño de la imagen ejecutable del proceso en bytes. Si esta información no está disponible, ModuleSize será cero.

[in, optional] ModuleName

Especifica el nombre del módulo simplificado que usa el motor del depurador. En la mayoría de los casos, esto coincide con el nombre del archivo de imagen excluyendo la extensión. Si esta información no está disponible, ModuleName se null.

[in, optional] ImageName

Especifica el nombre del archivo de imagen ejecutable del proceso, que puede incluir la ruta de acceso. Si esta información no está disponible, ImageName se NULL.

[in] CheckSum

Especifica la suma de comprobación de la imagen ejecutable del proceso. Si esta información no está disponible, checkSum será cero.

[in] TimeDateStamp

Especifica la hora y la marca de fecha del archivo ejecutable-imagen del proceso. Si esta información no está disponible, timeDateStamp será cero.

[in] InitialThreadHandle

Especifica el identificador del subproceso inicial del proceso. Este parámetro corresponde al campo hThread de la estructura CREATE_PROCESS_DEBUG_INFO. Si esta información no está disponible, InitialThreadHandle será NULL.

[in] ThreadDataOffset

Especifica un bloque de datos que mantiene el sistema operativo para este subproceso. Los datos reales del bloque son específicos del sistema operativo. Si esta información no está disponible, ThreadDataOffset se NULL.

[in] StartOffset

Especifica la dirección inicial del subproceso en el espacio de direcciones virtuales del proceso. Si esta información no está disponible, StartOffset se null.

Valor devuelto

Este método devuelve un valor DEBUG_STATUS_XXX, que indica cómo debe continuar la ejecución del destino después de que el motor procese este evento. Para obtener más información sobre cómo el motor trata este valor, consulte Supervisión de eventos.

Observaciones

El motor solo llama a este método si la marca DEBUG_EVENT_CREATE_PROCESS está establecida en la máscara devuelta por IDebugEventCallbacks::GetInterestMask.

Para obtener más información sobre el control de eventos, consulte Supervisión de eventos. Para obtener información sobre los subprocesos, vea Subprocesos y procesos.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)