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

Статья
08/07/2023

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

Синтаксис

HRESULT GetSystemVersionStringWide(
  [in]            ULONG  Which,
  [out, optional] PWSTR  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	Метод выполнен успешно. Однако буфер был слишком мал, поэтому строка была усечена.