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

Artigo
02/06/2025

O método GetSystemVersionString retorna uma cadeia de caracteres que descreve a versão do sistema operacional do destino.

Sintaxe

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

Parâmetros

[in] Which

Especifica qual cadeia de caracteres de versão retornar. Os valores possíveis são listados na tabela a seguir.

Valor	Cadeia de caracteres de versão
DEBUG_SYSVERSTR_SERVICE_PACK	Retorna uma descrição do service pack para o sistema operacional do destino. Por exemplo, "Service Pack 1".
DEBUG_SYSVERSTR_BUILD	Retorna uma descrição da versão de build do sistema operacional do destino. Por exemplo, "kernel32.dll versão: 5.1.2600.1106 (xpsp1.020828-1920)".

[out, optional] Buffer

Recebe a cadeia de caracteres de versão. Se buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em caracteres, do buffer que o Buffer especifica. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] StringSize

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 SizeString 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 era muito pequeno, portanto, a cadeia de caracteres 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)

Consulte também

GetSystemVersion

GetSystemVersionValues

IDebugControl4

Compartilhar via