IMsgStore::Advise

9/8/2008

The Avisar método registra para receber notificação de eventos especificados afetar armazenar a mensagem.

Syntax

HRESULT Advise (
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  ULONG ulEventMask,
  LPMAPIADVISESINK lpAdviseSink,
  ULONG FAR * lpulConnection
);

Parameters

• cbEntryID
  [no] Deve ser 0.

• lpEntryID
  [no] Deve ser NULL.

• ulEventMask
  [no] Uma máscara de valores que indica os tipos de eventos notificação que o cliente está interessado em e deve ser incluído no registro. Consulte Comentários Para válido sinalizadores que podem ser combinadas para este parâmetro.

• lpAdviseSink
  [no] Referência a um objeto coletor de avisos, implementado em IMAPIAdviseSink, para receber as notificações subseqüentes. Este objeto coletor de avisos deve ter já foi alocado; Ele não pode ser NULL.

• lpulConnection
  [out] Referência a um diferente de zero número que representa a conexão entre objeto sink informar do o chamador e a sessão.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  Indica sucesso.

• MAPI_E_NO_SUPPORT
  O provedor armazenar mensagem não registro suporte para notificação pelo armazenar a mensagem.

Remarks

Avisar Estabelece uma conexão entre objeto coletor de avisos do chamador e armazenar a mensagem ou um objeto em armazenar a mensagem. Essa conexão é usado para enviar notificações para o coletor de avisos quando uma ou mais eventos, conforme especificado na ulEventMask parâmetro, ocorrer para o objeto origem Advise.

The ulEventMask parâmetro é um máscara de bits composta de um ou mais dos sinalizadores descritos a seguinte tabela.

Sinalizador	Value	Description
fnevObjectCopied	0x00000040	Registra para notificações sobre um objeto que está sendo copiado.
fnevObjectCreated	0x00000004	Registra para notificações sobre a criação de um novo objeto.
fnevObjectDeleted	0x00000008	Registra para notificações sobre um objeto sendo excluído.
fnevObjectModified	0x00000010	Registra para notificações sobre um objeto que está sendo modificado.
fnevObjectMoved	0 x 00000020	Registra para notificações sobre um objeto que está sendo movida.

Para enviar uma notificação, o provedor armazenar mensagem ou MAPI chamadas do coletor de avisos o registrado IMAPIAdviseSink::OnNotify método). Um dos parâmetros para OnNotify, uma estrutura notificação, contém informações que descrevem o evento específico.

Após um chamar para Avisar foi bem-sucedida e antes IMsgStore::Unadvise foi chamado para cancelar o registro, estar preparado para o objeto sink informar para ser lançado. Você deve versão seu objeto sink informar após Avisar Retorna a menos que você tenha um uso de longo prazo específico para ele.

Requirements

Header	mapidefs.h
Library	cemapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPIAdviseSink::OnNotify
IMsgStore
IMsgStore::Unadvise

Other Resources

Messaging