IDebugClient::StartProcessServer method

The StartProcessServer method starts a process server.

Syntax


HRESULT StartProcessServer(
  [in]           ULONG Flags,
  [in]           PCSTR Options,
  [in, optional] PVOID Reserved
);

Parameters

Flags [in]

Specifies the class of the targets that will be available through the process server. This must be set to DEBUG_CLASS_USER_WINDOWS.

Options [in]

Specifies the connections options for this process server. These are the same options given to the -t option of the DbgSrv command line. For details on the syntax of this string, see Activating a Process Server.

Reserved [in, optional]

Set to NULL.

Return value

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

Return codeDescription
S_OK

The method was successful.

 

Remarks

The process server that is started will be accessible by remote clients through the transport specified in the Options parameter.

To stop the process server from the smart client, use the EndProcessServer method. To shut down the process server from the computer that it is running on, use Task Manager to end the process. If the instance of the debugger engine that used StartProcessServer is still running, it can use Execute to issue the debugger command .endsrv 0, which will end the process server (this is an exception to the usual behavior of .endsrv, which generally does not affect process servers).

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

Requirements

Target platform

Header

Dbgeng.h (include Dbgeng.h)

See also

IDebugClient
IDebugClient2
IDebugClient3
IDebugClient4
IDebugClient5
WaitForProcessServerEnd
ConnectProcessServer
EndProcessServer
DisconnectProcessServer

 

 

Send comments about this topic to Microsoft

Show: