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 Buffer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño, en caracteres, del búfer que especifica Buffer . 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, 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 era demasiado pequeño, por lo que la cadena se truncaba.

Comentarios

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

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (incluir Dbgeng.h)

Consulte también

GetSystemVersion

GetSystemVersionValues

IDebugControl4