Метод IDebugControl2::GetSystemVersion (dbgeng.h)

Статья
08/07/2023

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

Синтаксис

HRESULT GetSystemVersion(
  [out]           PULONG PlatformId,
  [out]           PULONG Major,
  [out]           PULONG Minor,
  [out, optional] PSTR   ServicePackString,
  [in]            ULONG  ServicePackStringSize,
  [out, optional] PULONG ServicePackStringUsed,
  [out]           PULONG ServicePackNumber,
  [out, optional] PSTR   BuildString,
  [in]            ULONG  BuildStringSize,
  [out, optional] PULONG BuildStringUsed
);

Параметры

[out] PlatformId

Получает идентификатор платформы. PlatformId всегда VER_PLATFORM_WIN32_NT для Windows на основе NT.

[out] Major

Получает 0xF, если операционная система целевого объекта является бесплатной сборкой, или 0xC, если операционная система является проверенной сборкой.

[out] Minor

Получает номер сборки для операционной системы целевого объекта.

[out, optional] ServicePackString

Получает строку для уровня пакета обновления целевого компьютера. Если ServicePackString имеет значение NULL, эти сведения не возвращаются. Если пакет обновления не установлен, ServicePackString может быть пустым.

[in] ServicePackStringSize

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

[out, optional] ServicePackStringUsed

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

[out] ServicePackNumber

Получает уровень пакета обновления операционной системы целевого объекта.

[out, optional] BuildString

Получает строку, идентифицирующая сборку системы. Если BuildString имеет значение NULL, эти сведения не возвращаются.

[in] BuildStringSize

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

[out, optional] BuildStringUsed

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

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

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

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

Требования

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

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

GetSystemVersionString

GetSystemVersionValues

IDebugControl

IDebugControl2

IDebugControl3