Compartir a través de


Método IDebugControl4::GetSystemVersionString (dbgeng.h)

El método GetSystemVersionString devuelve una cadena que describe la versión del sistema operativo del destino.

Sintaxis

HRESULT GetSystemVersionString(
  [in]            ULONG  Which,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG StringSize
);

Parámetros

[in] Which

Especifica la cadena de versión que se va a devolver. Los valores posibles se enumeran en la tabla siguiente.

Valor Cadena de versión
DEBUG_SYSVERSTR_SERVICE_PACK Devuelve una descripción del Service Pack para el sistema operativo del destino. Por ejemplo, "Service Pack 1".
DEBUG_SYSVERSTR_BUILD Devuelve una descripción de la versión de compilación del sistema operativo del destino. Por ejemplo, "kernel32.dll versión: 5.1.2600.1106 (xpsp1.020828-1920)".

[out, optional] Buffer

Recibe la cadena de versión. Si de búfer es NULL, no se devuelve esta información.

[in] BufferSize

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

[out, optional] StringSize

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 SizeString 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 era demasiado pequeño, por lo que la cadena 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)

Consulte también

GetSystemVersion

GetSystemVersionValues

IDebugControl4