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

Artigo
02/23/2024

O método GetSystemVersion retorna informações que identificam o sistema operacional no computador que está executando o destino atual.

Sintaxe

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

Recebe a ID da plataforma. PlatformId é sempre VER_PLATFORM_WIN32_NT para Windows baseado em NT.

[out] Major

Recebe 0xF se o sistema operacional do destino for um build gratuito ou 0xC se o sistema operacional for um build verificado.

[out] Minor

Recebe o número de build para o sistema operacional do destino.

[out, optional] ServicePackString

Recebe a cadeia de caracteres para o nível do service pack do computador de destino. Se ServicePackString for NULL, essas informações não serão retornadas. Se nenhum service pack estiver instalado, ServicePackString poderá estar vazio.

[in] ServicePackStringSize

Especifica o tamanho, em caracteres, do buffer especificado por ServicePackString . Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] ServicePackStringUsed

Recebe o tamanho, em caracteres, da cadeia de caracteres do nível do service pack. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se ServicePackStringUsed for NULL, essas informações não serão retornadas.

[out] ServicePackNumber

Recebe o nível do service pack do sistema operacional do destino.

[out, optional] BuildString

Recebe a cadeia de caracteres que identifica o build do sistema. Se BuildString for NULL, essas informações não serão retornadas.

[in] BuildStringSize

Especifica o tamanho, em caracteres, do buffer especificado por BuildString . Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] BuildStringUsed

Recebe o tamanho, em caracteres, da cadeia de caracteres que identifica o build. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se BuildStringUsed for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, o buffer ServicePackString ou o buffer BuildString eram muito pequenos e a cadeia de caracteres correspondente era truncada.