Метод IDebugClient3::GetKernelConnectionOptions (dbgeng.h)

  • Статья

Метод GetKernelConnectionOptions возвращает параметры подключения для текущего целевого объекта ядра.

Синтаксис

HRESULT GetKernelConnectionOptions(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG OptionsSize
);

Параметры

[out, optional] Buffer

Указывает буфер для получения параметров подключения.

[in] BufferSize

Задает размер буфера буфера в символах. Этот размер включает пробел для завершающего символа "\0".

[out, optional] OptionsSize

Получает размер параметров подключения в символах. Этот размер включает пробел для завершающего символа "\0". Если параметр OptionsSize имеет значение NULL, эти сведения не возвращаются.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата Описание
S_OK
 Метод выполнен успешно.
S_FALSE
 Размер строки был больше размера буфера, поэтому она была усечена, чтобы поместиться в буфер.
E_UNEXPECTED
 Текущий целевой объект не является стандартным целевым объектом активного ядра.

Комментарии

Этот метод доступен только для целевых объектов ядра в реальном времени, которые не являются локальными и не подключены через eXDI.

Возвращаемые параметры подключения совпадают с параметрами, используемыми для подключения к ядру.

Дополнительные сведения о подключении к динамическим целевым объектам в режиме ядра см. в разделе Live Kernel-Mode Targets.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

AttachKernel

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5