HrDispatchNotifications

Aplica-se a: Outlook 2013 | Outlook 2016

Força o envio de todas as notificações na fila.

Propriedade	Valor
Arquivo de cabeçalho:	Mapiutil.h
Implementado por:	MAPI
Chamado por:	Aplicativos cliente e provedores de serviços

HRESULT HrDispatchNotifications(
  ULONG ulFlags
);

Parâmetros

ulFlags

[in] Reservados; deve ser zero.

Valor de retorno

S_OK

Todas as notificações enfileiradas foram enviadas.

MAPI_E_USER_CANCEL

WM_QUIT, WM_QUERYENDSESSION ou WM_ENDSESSION foi recebido.

MAPI_E_NOT_INITIALIZED

O MAPI não foi inicializado.

Comentários

A função HrDispatchNotifications faz com que o MAPI envie todas as notificações que estão atualmente enfileiradas no mecanismo de notificação MAPI sem aguardar uma expedição de mensagem. Isso pode ter um efeito benéfico na utilização da memória. Para obter mais informações, consulte Forçar uma notificação.

Notas para chamadores

Alguns aplicativos esperam por uma mensagem de notificação em um loop de tempo limite usando as funções Windows PeekMessage e DispatchMessage . Em todas, exceto nas plataformas mais rápidas, esses aplicativos podem ter um desempenho ruim ou até mesmo bloqueio de notificações. O uso de HrDispatchNotifications não só reduz o código, mas melhora o desempenho.