Поделиться через


Метод IDebugBreakpoint2::GetCommand (dbgeng.h)

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

Синтаксис

HRESULT GetCommand(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG CommandSize
);

Параметры

[out, optional] Buffer

Строка команды, которая выполняется при срабатывании точки останова. Если параметр Buffer имеет значение NULL, эти сведения не возвращаются.

[in] BufferSize

Размер (в символах) буфера, на который указывает Buffer .

[out, optional] CommandSize

Размер командной строки. Если параметр CommandSize имеет значение NULL, эти сведения не возвращаются.

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

Код возврата Описание
S_OK
Метод выполнен успешно.
S_FALSE
Метод был успешным, но буфер не был достаточно велик для хранения командной строки, поэтому командная строка была усечена в соответствии с размером.
 

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

Комментарии

Командная строка — это список команд отладчика, разделенных точкой с запятой. Эти команды выполняются при каждом срабатывании точки останова. Команды выполняются до того, как подсистема сообщит о том, что точка останова активирована.

Метод GetParameters также возвращает размер команды точки останова CommandSize.

Дополнительные сведения о свойствах точки останова см. в разделе Управление флагами и параметрами точек останова.

Требования

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