Compartilhar via


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

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 especificado pelo Buffer . 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.

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 era muito pequeno, portanto, a cadeia de caracteres foi truncada.

Comentários

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

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

GetSystemVersion

GetSystemVersionValues

IDebugControl4