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

Artigo
02/06/2025

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

Receberá 0xF se o sistema operacional do destino for um de build gratuito ou 0xC se o sistema operacional for um de buildverificado.

[out] Minor

Recebe o número de build do 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 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 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.

Valor de retorno

Esse método também pode retornar valores de erro. Consulte de 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 era muito pequeno e a cadeia de caracteres correspondente foi truncada.

Observações

Para obter mais informações, consulte de Informações de Destino.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h, Ntddk.h)

Consulte também

GetSystemVersionString

GetSystemVersionValues

IDebugControl

IDebugControl2

IDebugControl3

Partilhar via