HrAllocAdviseSink

Aplica-se a: Outlook 2013 | Outlook 2016

Cria um objeto coletor de aconselhamento, dado um contexto especificado pela implementação de chamada e uma função de retorno de chamada a ser disparada por uma notificação de evento.

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

STDAPI HrAllocAdviseSink(
  LPNOTIFCALLBACK lpfnCallback,
  LPVOID lpvContext,
  LPMAPIADVISESINK FAR * lppAdviseSink
);

Parâmetros

lpfnCallback

[in] Ponteiro para uma função de retorno de chamada com base no protótipo NOTIFCALLBACK que MAPI deve chamar quando ocorrer um evento de notificação para o coletor de aconselhamento recém-criado.

lpvContext

[in] Ponteiro para dados de chamador passados para a função de retorno de chamada quando MAPI os chama. Os dados do chamador podem representar um endereço de significado para o cliente ou provedor. Normalmente, para o código C++, o parâmetro lpvContext representa um ponteiro para o endereço de um objeto.

lppAdviseSink

[out] Ponteiro para um ponteiro para um objeto de coletor de aconselhamento.

Valor de retorno

Nenhum.

Comentários

Para usar a função HrAllocAdviseSink , um aplicativo cliente ou provedor de serviços cria um objeto para receber notificações, cria uma função de retorno de chamada de notificação com base no protótipo de função NOTIFCALLBACK que acompanha esse objeto e passa um ponteiro para o objeto na função HrAllocAdviseSink como o valor lpvContext . Fazer isso executa uma notificação; e como parte do processo de notificação, o MAPI chama a função de retorno de chamada com o ponteiro do objeto como o contexto.

O MAPI implementa seu mecanismo de notificação de forma assíncrona. No C++, o retorno de chamada de notificação pode ser um método de objeto. Se o objeto que gera a notificação não estiver presente, o cliente ou provedor que solicita a notificação deverá manter uma contagem de referência separada para esse objeto para o coletor de aconselhamento do objeto.

Cuidado

HrAllocAdviseSink deve ser usado com moderação; é mais seguro para os clientes criarem seus próprios coletores de consultoria.