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 será 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 será 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 será 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 de archivo de imagen excepto la extensión. Si esta información no está disponible, ModuleName será 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 será 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 marca de fecha y hora del archivo de imagen ejecutable 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 el sistema operativo mantiene para este subproceso. Los datos reales del bloque son específicos del sistema operativo. Si esta información no está disponible, ThreadDataOffset será 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 será NULL.

Valor devuelto

Este método devuelve un valor de 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 trata el motor este valor, consulte Supervisión de eventos.

Comentarios

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	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (incluir Dbgeng.h)