Compartilhar via

Método IWindowsUpdateAgentInfo::GetInfo (wuapi.h)

  • Artigo

Recupera informações de versão sobre o WUA (Agente Windows Update).

Sintaxe

HRESULT GetInfo(
  [in]  VARIANT varInfoIdentifier,
  [out] VARIANT *retval
);

Parâmetros

[in] varInfoIdentifier

Um valor de cadeia de caracteres literal que especifica o tipo de informação que o parâmetro retval retorna. A tabela a seguir lista os valores de cadeia de caracteres possíveis atuais.

ApiMajorVersion Recupera a versão principal atual do WUA.
ApiMinorVersion Recupera a versão secundária atual do WUA.
ProductVersionString Recupera a versão de arquivo do arquivo Wuapi.dll no formato de cadeia de caracteres.

[out] retval

  • Retorna a versão principal da API WUA como um valor LONG dentro da variável VARIANT se o valor do parâmetro varInfoIdentifier for ApiMajorVersion.
  • Retorna a versão secundária da API WUA como um valor LONG dentro da variável VARIANT se o valor de varInfoIdentifier for ApiMinorVersion.
  • Retorna a versão de arquivo do arquivo Wuapi.dll como um valor BSTR dentro da variável VARIANT se o valor de varInfoIdentifier for ProductVersionString.
Nota O formato de uma cadeia de caracteres retornada é o seguinte: "<Windows-major-version>.<Versão secundária do> Windows. <build>.<update>".
 

Retornar valor

Retorna S_OK se tiver êxito. Caso contrário, retornará um COM ou Windows

código de erro.

Comentários

A interface IWindowsUpdateAgentInfo pode exigir que você atualize o WUA. Para obter mais informações, consulte Atualizando Windows Update Agent.

A versão principal será incrementada uma vez para cada versão se ocorrer uma alteração nas interfaces da API WUA. A versão secundária será incrementada uma vez para cada versão se ocorrer uma alteração nas interfaces existentes da API WUA.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional com SP3 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003, Windows 2000 Server com SP3 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wuapi.h
Biblioteca Wuguid.lib
DLL Wuapi.dll

Confira também

IWindowsUpdateAgentInfo