ICorDebugRemote::CreateProcessEx Method

Article
09/15/2021

Launches a process on a remote machine under the debugger.

Syntax

HRESULT CreateProcessEx (
    [in]  ICorDebugRemoteTarget*      pRemoteTarget,
    [in]  LPCWSTR                     lpApplicationName,
    [in]  LPWSTR                      lpCommandLine,
    [in]  LPSECURITY_ATTRIBUTES       lpProcessAttributes,
    [in]  LPSECURITY_ATTRIBUTES       lpThreadAttributes,
    [in]  BOOL                        bInheritHandles,
    [in]  DWORD                       dwCreationFlags,
    [in]  PVOID                       lpEnvironment,
    [in]  LPCWSTR                     lpCurrentDirectory,
    [in]  LPSTARTUPINFOW              lpStartupInfo,
    [in]  LPPROCESS_INFORMATION       lpProcessInformation,
    [in]  CorDebugCreateProcessFlags  debuggingFlags,
    [out] ICorDebugProcess**          ppProcess
);

Parameters

pRemoteTarget [in] Pointer to an ICorDebugRemoteTarget Interface. Used to determine the remote machine on which the process will be launched.

lpApplicationName [in] Pointer to a null-terminated string that specifies the module to be executed by the launched process. The module is executed in the security context of the calling process.

lpCommandLine [in] Pointer to a null-terminated string that specifies the command line to be executed by the launched process.

lpProcessAttributes [in] Unused for remote debugging.

lpThreadAttributes [in] Unused for remote debugging.

bInheritHandles [in] Unused for remote debugging.

dwCreationFlags [in] Unused for remote debugging.

lpEnvironment [in] Pointer to an environment block for the new process.

lpCurrentDirectory [in] Pointer to a null-terminated string that specifies the full path to the current directory for the process. If this parameter is null, the new process will have the same current drive and directory as the calling process.

lpStartupInfo [in] Unused for remote debugging.

lpProcessInformation [in] Unused for remote debugging.

debuggingFlags [in] Unused for remote debugging.

ppProcess [out] A pointer to the address of a"ICorDebugProcess Interface" object that represents the process.

Return Value

S_OK Successfully launched the process on the remote machine and returned an "ICorDebugProcess Interface" for debugging.

E_FAIL (or other E_ return codes) Unable to launch the process on the remote machine and return an "ICorDebugProcess Interface" for debugging.

Remarks

Mixed-mode debugging is not supported in Silverlight.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Versions: 4.5, 4, 3.5 SP1

Share via