IMAPIOfflineMgr::Advise
Aplica-se a: Outlook 2013 | Outlook 2016
Registra um cliente para receber retornos de chamada em um objeto offline.
HRESULT COfflineObj::Advise(
ULONG ulFlags,
MAPIOFFLINE_ADVISEINFO* pAdviseInfo,
ULONG* pulAdviseToken
);
Parâmetros
ulFlags
[in] Sinalizadores que modificam o comportamento. Há suporte apenas para o valor MAPIOFFLINE_ADVISE_DEFAULT.
pAdviseInfo
[in] Informações sobre o tipo de retorno de chamada, quando receber um retorno de chamada, uma interface de retorno de chamada para o chamador e outros detalhes. Ele também contém um token de cliente que o Outlook usa no envio de retornos de chamada de notificação subsequentes para o chamador do cliente.
pulAdviseToken
[out] Um token de aconselhamento retornado ao chamador do cliente para posteriormente cancelar o retorno de chamada para o objeto.
Valor de retorno
S_OK
A chamada foi bem-sucedida.
E_INVALIDARG
Um parâmetro inválido foi especificado.
E_NOINTERFACE
A interface de retorno de chamada especificada no pAdviseInfo não é válida.
Comentários
Ao abrir um objeto offline usando HrOpenOfflineObj, um cliente obtém um objeto offline que dá suporte a IMAPIOfflineMgr. O cliente pode marcar para os tipos de retornos de chamada compatíveis com o objeto usando IMAPIOffline::GetCapabilities. O cliente pode determinar o tipo e outros detalhes sobre o retorno de chamada desejado e, em seguida, chamar IMAPIOfflineMgr::Aconselhar a registrar para receber esses retornos de chamada sobre o objeto.