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

Digite: 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).

Retornar valor

Tipo: DWORD

Retorna um dos valores a seguir.

Código de retorno	Descrição
IDNO	O usuário clicou no botão Não Atualizar na caixa de diálogo.
IDYES	O usuário clicou no botão Atualizar Agora ou Sobre Atualização . O aplicativo deve navegar até a página HTML referenciada pelo membro szHREF da estrutura apontada por psdi.
IDIGNORE	Não há nenhuma atualização de software pendente.
IDABORT	Ocorreu um erro.

Comentários

A maneira preferida de lidar com atualizações é criar um CDF (Formato de Definição de Canal) com um vocabulário osD (Open Software Description) e tornar o atalho com reconhecimento de OSD. Consulte a documentação 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 atualização de software marcar, ele deverá usar essa função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj.h
DLL	Shdocvw.dll