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