ConnectProcessServer

The ConnectProcessServer and ConnectProcessServerWide methods connect to a process server.

HRESULT
  IDebugClient::ConnectProcessServer(
    IN PCSTR  RemoteOptions,
    OUT PULONG64  Server
    );

HRESULT
  IDebugClient5::ConnectProcessServerWide(
    IN PCWSTR  RemoteOptions,
    OUT PULONG64  Server
    );

#ifdef UNICODE
#define ConnectProcessServerT ConnectProcessServerWide
#else
#define ConnectProcessServerT ConnectProcessServer
#endif

Parameters

RemoteOptions

Specifies how the debugger engine will connect with the process server. These are the same options passed to the -premote option on the WinDbg and CDB command lines. For details on the syntax of this string, see Activating a Smart Client.

Server

Receives a handle for the process server. This handle is used when creating or attaching to processes by using the process server.

Return Value

S_OK

The method was successful.

This method may also return error values. See Return Values for more details.

Interface Version

ConnectProcessServer is available in all versions of IDebugClient. ConnectProcessServerWide is available in IDebugClient5 and later versions.

Comments

For more information about process servers and remote debugging, see Process Servers, Kernel Connection Servers, and Smart Clients.

Requirements

Headers: Defined in dbgeng.h. Include dbgeng.h.

See Also

StartProcessServer, DisconnectProcessServer, EndProcessServer, AttachProcess, CreateProcess2, CreateProcessAndAttach2, GetRunningProcessDescription, GetRunningProcessSystemIdByExecutableName, GetRunningProcessSystemIds