Método IDebugControl::GetSystemVersion (dbgeng.h)

Artículo
08/07/2023

El método GetSystemVersion devuelve información que identifica el sistema operativo en el equipo que ejecuta el destino actual.

Sintaxis

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
);

Parámetros

[out] PlatformId

Recibe el identificador de la plataforma. PlatformId siempre se VER_PLATFORM_WIN32_NT para Windows basado en NT.

[out] Major

Recibe 0xF si el sistema operativo del destino es una compilación gratuita o 0xC si el sistema operativo es una compilación comprobada.

[out] Minor

Recibe el número de compilación del sistema operativo del destino.

[out, optional] ServicePackString

Recibe la cadena para el nivel de Service Pack del equipo de destino. Si ServicePackString es NULL, no se devuelve esta información. Si no hay ningún Service Pack instalado, ServicePackString puede estar vacío.

[in] ServicePackStringSize

Especifica el tamaño, en caracteres, del búfer que especifica ServicePackString . Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] ServicePackStringUsed

Recibe el tamaño, en caracteres, de la cadena del nivel de Service Pack. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si ServicePackStringUsed es NULL, esta información no se devuelve.

[out] ServicePackNumber

Recibe el nivel de Service Pack del sistema operativo del destino.

[out, optional] BuildString

Recibe la cadena que identifica la compilación del sistema. Si BuildString es NULL, esta información no se devuelve.

[in] BuildStringSize

Especifica el tamaño, en caracteres, del búfer que especifica BuildString . Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] BuildStringUsed

Recibe el tamaño, en caracteres, de la cadena que identifica la compilación. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si BuildStringUsed es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, el búfer ServicePackString o el búfer BuildString eran demasiado pequeños y la cadena correspondiente se truncaba.