IDebugClient5::CreateProcess2 方法 (dbgeng.h)
CreateProcess2 方法會執行指定的命令來建立新的進程。
語法
HRESULT CreateProcess2(
[in] ULONG64 Server,
[in] PSTR CommandLine,
[in] PVOID OptionsBuffer,
[in] ULONG OptionsBufferSize,
[in, optional] PCSTR InitialDirectory,
[in, optional] PCSTR Environment
);
參數
[in] Server
指定將附加至進程的進程伺服器。 如果 伺服器 為零,引擎會在不使用進程伺服器的情況下建立本機進程。
[in] CommandLine
指定要執行的命令行,以建立新的進程。
[in] OptionsBuffer
指定進程建立選項。 OptionsBuffer 是 DEBUG_CREATE_PROCESS_OPTIONS 結構的指標。
[in] OptionsBufferSize
指定緩衝區的大小 OptionsBuffer。 這應該設定為 sizeof(DEBUG_CREATE_PROCESS_OPTIONS)。
[in, optional] InitialDirectory
指定進程的起始目錄。 如果 InitialDirectoryNULL,則會使用進程伺服器的目前目錄。
[in, optional] Environment
指定新進程的環境區塊。 環境區塊是由 Null 終止字串的 Null 終止區塊所組成。 每個字串的格式如下:
name=value
請注意,環境區塊的最後兩個字元都是 NULL:一個用來終止字串,另一個用來終止區塊。
如果 Environment 設定為 NULL,則新進程會繼承進程伺服器的環境區塊。 如果 OptionsBuffer中設定了DEBUG_CREATE_PROCESS_THROUGH_RTL旗標,則 環境 必須 NULL。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
言論
這個方法僅適用於即時使用者模式偵錯。
如果 CreateFlags 包含旗標DEBUG_PROCESS或DEBUG_ONLY_THIS_PROCESS,引擎也會附加至新建立的進程。 這類似於 createProcessAndAttach2 的 行為,其自變數 ProcessId 設為零。
如需建立及附加至即時使用者模式目標的詳細資訊,請參閱 Live User-Mode Targets。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |