Função SoftwareUpdateMessageBox (shlobj.h)

Exibe uma caixa de mensagem padrão que pode ser usada para notificar um usuário de que um aplicativo foi atualizado.

Sintaxe

DWORD SoftwareUpdateMessageBox(
  [in, optional]  HWND           hWnd,
  [in]            PCWSTR         pszDistUnit,
                  DWORD          dwFlags,
  [out, optional] LPSOFTDISTINFO psdi
);

Parâmetros

[in, optional] hWnd

Tipo: HWND

Um identificador para a janela pai.

[in] pszDistUnit

Tipo: PCWSTR

O valor da cadeia de caracteres que contém o identificador da unidade de distribuição de código. Para controles ActiveX, pszDistUnit normalmente é um GUID.

dwFlags

Tipo: DWORD

Reservado. Deve ser definido como zero.

[out, optional] psdi

Tipo: LPSOFTDISTINFO

Um ponteiro para uma estrutura SOFTDISTINFO que, quando esse método retorna com êxito, recebe as informações de atualização. O membro cbSize deve ser inicializado para o sizeof(SOFTDISTINFO).

Valor de retorno

Tipo: DWORD

Retorna um dos seguintes valores.

Observações

A maneira preferida de lidar com atualizações é criar um CDF (Formato de Definição de Canal) com um vocabulário de OSD (Open Software Description) e tornar o osD de atalho com reconhecimento de OSD. Consulte a documentação do Formato de Definição de Canal para obter detalhes.

A função SoftwareUpdateMessageBox destina-se a ser usada no caso em que os ganchos de atalho do Shell não funcionam. Um exemplo é um aplicativo que não foi instalado no menu iniciar. Se esse aplicativo precisar fazer sua própria verificação de atualização de software, ele deverá usar essa função.

Requirements