IDebugClient4::SetKernelConnectionOptions method (dbgeng.h)

The SetKernelConnectionOptions method updates some of the connection options for a live kernel target.

Syntax

HRESULT SetKernelConnectionOptions(
  [in] PCSTR Options
);

Parameters

[in] Options

Specifies the connection options to update. The possible values are:

Value Description
"resync" Re-synchronize the connection between the debugger engine and the kernel. For more information, see Synchronizing with the Target Computer.
"cycle_speed" For kernel connections through a COM port, cycle through the supported baud rates; for other connections, do nothing. For more information, see CTRL+A (Toggle Baud Rate).

Return value

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

Return code Description
S_OK
The method was successful.
E_UNEXPECTED
The current target is not a live (non-local) kernel target.

Remarks

This method is available only for live kernel targets that are not local and not connected through eXDI. This method is reentrant.

For more information about connecting to live kernel-mode targets, see Live Kernel-Mode Targets.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

AttachKernel

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5