IDebugClient5::CreateProcess2Wide 方法 (dbgeng.h)
CreateProcess2Wide 方法执行指定的命令以创建新进程。
语法
HRESULT CreateProcess2Wide(
[in] ULONG64 Server,
[in] PWSTR CommandLine,
[in] PVOID OptionsBuffer,
[in] ULONG OptionsBufferSize,
[in, optional] PCWSTR InitialDirectory,
[in, optional] PCWSTR Environment
);
参数
[in] Server
指定将附加到进程的进程服务器。 如果 Server 为零,引擎将在不使用进程服务器的情况下创建本地进程。
[in] CommandLine
指定要执行以创建新进程的命令行。
[in] OptionsBuffer
指定进程创建选项。 OptionsBuffer 是指向 DEBUG_CREATE_PROCESS_OPTIONS 结构的指针。
[in] OptionsBufferSize
指定缓冲区 OptionsBuffer 的大小。 这应设置为 sizeof (DEBUG_CREATE_PROCESS_OPTIONS) 。
[in, optional] InitialDirectory
指定进程的起始目录。 如果 InitialDirectory 为 NULL,则使用进程服务器的当前目录。
[in, optional] Environment
为新进程指定环境块。 环境块由以 null 结尾的字符串的以 null 结尾的块组成。 每个字符串的格式如下:
name=value
请注意,环境块的最后两个字符都是 NULL:一个字符用于终止字符串,另一个字符用于终止块。
如果 Environment 设置为 NULL,则新进程将继承进程服务器的环境块。 如果在 OptionsBuffer 中设置了DEBUG_CREATE_PROCESS_THROUGH_RTL标志,则 Environment 必须为 NULL。
返回值
此方法也可能返回错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
注解
此方法仅适用于实时用户模式调试。
如果 CreateFlags 包含DEBUG_PROCESS或DEBUG_ONLY_THIS_PROCESS标志之一,则引擎还将附加到新创建的进程。 这类似于 CreateProcessAndAttach2 的行为,其参数 ProcessId 设置为零。
有关创建和附加到实时用户模式目标的详细信息,请参阅 实时 User-Mode 目标。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |