IDebugEventCallbacks::CreateProcess-Methode (dbgeng.h)

Artikel
02/06/2025

Die CreateProcess- Rückrufmethode wird vom Modul aufgerufen, wenn ein Ereignis zum Debuggen von Prozessen im Ziel auftritt.

Syntax

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
);

Parameter

[in] ImageFileHandle

Gibt das Handle für die Bilddatei des Prozesses an. Wenn diese Informationen nicht verfügbar sind, wird ImageFileHandle-NULL-.

[in] Handle

Gibt das Handle für den Prozess an. Dieser Parameter entspricht dem feld hProcess in der CREATE_PROCESS_DEBUG_INFO Struktur. Wenn diese Informationen nicht verfügbar sind, wird ImageFileHandle-NULL-.

[in] BaseOffset

Gibt die Basisadresse des ausführbaren Bilds des Prozesses im Adressraum des Ziels an. Wenn diese Informationen nicht verfügbar sind, wird BaseOffset-NULL-.

[in] ModuleSize

Gibt die größe des ausführbaren Bilds des Prozesses in Byte an. Wenn diese Informationen nicht verfügbar sind, ist ModuleSize null.

[in, optional] ModuleName

Gibt den vereinfachten Modulnamen an, der vom Debuggermodul verwendet wird. In den meisten Fällen entspricht dies dem Namen der Bilddatei, mit Ausnahme der Erweiterung. Wenn diese Informationen nicht verfügbar sind, wird ModuleName-NULL-.

[in, optional] ImageName

Gibt den Dateinamen der ausführbaren Datei des Prozesses an, der den Pfad enthalten kann. Wenn diese Informationen nicht verfügbar sind, wird ImageName-NULL-.

[in] CheckSum

Gibt die Prüfsumme des ausführbaren Images des Prozesses an. Wenn diese Informationen nicht verfügbar sind, ist CheckSum null.

[in] TimeDateStamp

Gibt den Zeit- und Datumsstempel der ausführbaren Bilddatei des Prozesses an. Wenn diese Informationen nicht verfügbar sind, ist TimeDateStamp- null.

[in] InitialThreadHandle

Gibt das Handle für den anfänglichen Thread des Prozesses an. Dieser Parameter entspricht dem hThread Feld in der CREATE_PROCESS_DEBUG_INFO Struktur. Wenn diese Informationen nicht verfügbar sind, wird InitialThreadHandle-NULL-.

[in] ThreadDataOffset

Gibt einen Datenblock an, den das Betriebssystem für diesen Thread verwaltet. Die tatsächlichen Daten im Block sind betriebssystemspezifisch. Wenn diese Informationen nicht verfügbar sind, wird ThreadDataOffset-NULL-.

[in] StartOffset

Gibt die Startadresse des Threads im virtuellen Adressraum des Prozesses an. Wenn diese Informationen nicht verfügbar sind, wird StartOffset-NULL-.

Rückgabewert

Diese Methode gibt einen DEBUG_STATUS_XXX Wert zurück, der angibt, wie die Ausführung des Ziels fortgesetzt werden soll, nachdem das Modul dieses Ereignis verarbeitet hat. Ausführliche Informationen zur Behandlung dieses Werts finden Sie unter Monitoring Events.

Bemerkungen

Diese Methode wird nur vom Modul aufgerufen, wenn das DEBUG_EVENT_CREATE_PROCESS Flag in der Maske festgelegt wird, die von IDebugEventCallbacks::GetInterestMaskzurückgegeben wird.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events. Informationen zu Threads finden Sie unter Threads und Prozesse.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über