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

Метод IDebugControl4::GetSystemVersionString (dbgeng.h)

  • Статья

Метод GetSystemVersionString возвращает строку, описывающую версию операционной системы целевого объекта.

Синтаксис

HRESULT GetSystemVersionString(
  [in]            ULONG  Which,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG StringSize
);

Параметры

[in] Which

Указывает возвращаемую строку версии. Возможные значения перечислены в следующей таблице.

Значение Строка версии
DEBUG_SYSVERSTR_SERVICE_PACK Возвращает описание пакета обновления для операционной системы целевого объекта. Например, "Пакет обновления 1".
DEBUG_SYSVERSTR_BUILD Возвращает описание версии сборки операционной системы целевого объекта. Например, "kernel32.dll версия: 5.1.2600.1106 (xpsp1.020828-1920)".

[out, optional] Buffer

Получает строку версии. Если параметр Buffer имеет значение NULL, эта информация не возвращается.

[in] BufferSize

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

[out, optional] StringSize

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

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

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

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

Комментарии

Дополнительные сведения см. в разделе Сведения о целевом объекте.

Требования

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

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

GetSystemVersion

GetSystemVersionValues

IDebugControl4