IMAPIOfflineMgr::Advise
Gilt für: Outlook 2013 | Outlook 2016
Registriert einen Client, um Rückrufe für ein Offlineobjekt zu empfangen.
HRESULT COfflineObj::Advise(
ULONG ulFlags,
MAPIOFFLINE_ADVISEINFO* pAdviseInfo,
ULONG* pulAdviseToken
);
Parameter
ulFlags
[in] Flags, die das Verhalten ändern. Nur der Wert MAPIOFFLINE_ADVISE_DEFAULT wird unterstützt.
pAdviseInfo
[in] Informationen zum Typ des Rückrufs, wann ein Rückruf empfangen werden soll, eine Rückrufschnittstelle für den Aufrufer und weitere Details. Es enthält auch ein Clienttoken, das Outlook zum Senden nachfolgender Benachrichtigungsrückrufe an den Clientaufrufer verwendet.
pulAdviseToken
[out] Ein Empfehlungstoken, das an den Clientaufrufer zurückgegeben wird, um den Rückruf für das -Objekt anschließend abzubrechen.
Rückgabewert
S_OK
Der Aufruf war erfolgreich.
E_INVALIDARG
Ein ungültiger Parameter wurde angegeben.
E_NOINTERFACE
Die in pAdviseInfo angegebene Rückrufschnittstelle ist ungültig.
Hinweise
Beim Öffnen eines Offlineobjekts mit HrOpenOfflineObj ruft ein Client ein Offlineobjekt ab, das IMAPIOfflineMgr unterstützt. Der Client kann mithilfe von IMAPIOffline::GetCapabilities überprüfen, welche Arten von Rückrufen vom Objekt unterstützt werden. Der Client kann den Typ und andere Details zum gewünschten Rückruf bestimmen und dann IMAPIOfflineMgr::Advise aufrufen, um sich zu registrieren, um solche Rückrufe zum Objekt zu erhalten.