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

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 un compilación gratuita, o 0xC si el sistema operativo es un 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, esta información no se devuelve. 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 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 buildString especifica. 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, no se devuelve esta información.

Valor devuelto

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

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

Observaciones

Para obtener más información, vea información de destino.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h, Ntddk.h)

Consulte también

GetSystemVersionString

GetSystemVersionValues

IDebugControl

IDebugControl2

IDebugControl3