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

Статья
02/06/2025

Метод 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

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

[in] ServicePackStringSize

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

[out, optional] ServicePackStringUsed

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

[out] ServicePackNumber

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

[out, optional] BuildString

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

[in] BuildStringSize

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

[out, optional] BuildStringUsed

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

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

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

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