Método IDebugControl3::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 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, 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 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 |
---|---|
|
Método realizado correctamente. |
|
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. |
Comentarios
Para obtener más información, vea Información de destino.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | dbgeng.h (include Dbgeng.h, Ntddk.h) |