Método ISyncMgrSynchronize::ShowError (mobsync.h)

Artigo
08/24/2023

Chamado pelo gerenciador de sincronização em um manipulador de aplicativos registrado quando um usuário clica duas vezes em uma mensagem associada na guia de erro.

Sintaxe

HRESULT ShowError(
  [in] HWND    hWndParent,
  [in] REFGUID ErrorID
);

Parâmetros

[in] hWndParent

Digite: HWND

Um identificador para o HWND pai que um aplicativo registrado deve usar para exibir uma interface do usuário. Esse valor pode ser NULL.

[in] ErrorID

Tipo: REFGUID

Um identificador de erro associado a esta mensagem de erro. Esse valor é passado no método LogError .

Valor retornado

Tipo: HRESULT

Esse método dá suporte aos valores retornados padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, e o seguinte:

Código de retorno	Descrição
S_OK	A chamada foi concluída com êxito.

Comentários

Os manipuladores devem retornar o mais rápido possível desse método e chamar o método ShowErrorCompleted . Um manipulador pode fazer uma chamada para ShowErrorCompleted antes de retornar desse método. Se um manipulador retornar um código de falha desse método, ele não deverá chamar o método ShowErrorCompleted .

Os aplicativos podem exibir elementos de interface do usuário nesse método mesmo que o sinalizador SYNCMGRFLAG_MAYBOTHERUSER não esteja definido no parâmetro dwSyncFlags do método ISyncMgrSynchronize::Initialize . Os aplicativos ainda devem chamar EnableModeless e marcar o código de retorno antes de mostrar uma interface do usuário.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [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	mobsync.h
DLL	Mobsync.dll