Freigeben über


HrOpenOfflineObj

Gilt für: Outlook 2013 | Outlook 2016

Öffnet ein Offlineobjekt basierend auf einem angegebenen Profil.

QuickInfo

Eigenschaft Wert
Exportiert von:
msmapi32.dll
Aufgerufen von:
Client
Implementiert von:
Outlook
typedef HRESULT (STDMETHODCALLTYPE HROPENOFFLINEOBJ)( 
      ULONG ulReserved, 
      LPCWSTR pwszProfileNameIn, 
      const GUID* pGUID, 
      const GUID* pReserved, 
      IMAPIOfflineMgr** ppOfflineObj); 

Parameter

ulReserved

[in] Dieser Parameter wird nicht verwendet. Sie muss 0 sein.

pwszProfileNameIn

[in] Der Name des Profils, für das das Offlineobjekt verwendet wird. Sie muss in Unicode ausgedrückt werden.

pGUID

[in] Zeiger auf eine GUID, die verwendet werden kann, um dieses Objekt von anderen Offlineobjekten eindeutig zu identifizieren. Es muss GUID_GlobalState werden.

Erhalten

[in] Dieser Parameter wird nicht verwendet. Es muss NULL sein.

ppOfflineObj

[out] Ein Zeiger auf das angeforderte Offlineobjekt. Der Aufrufer kann diesen Zeiger verwenden, um auf die IMAPIOfflineMgr : IMAPIOffline-Schnittstelle zuzugreifen, um die von diesem Objekt unterstützten Rückrufe zu finden und Rückrufe dafür einzurichten.

Rückgabewerte

S_OK

  • Der Funktionsaufruf ist erfolgreich.

MAPI_E_NOT_FOUND

  • Fehler beim Funktionsaufruf.

Hinweise

Dies ist der erste Aufruf, den ein Client ausgibt, wenn der Client über Änderungen des Verbindungszustands für ein bestimmtes Profil benachrichtigt werden möchte. Beim Aufrufen von HrOpenOfflineObj ruft der Client ein Offlineobjekt ab, das IMAPIOfflineMgr unterstützt. Der Client kann überprüfen, welche Arten von Rückrufen vom Objekt unterstützt werden (mithilfe von IMAPIOffline::GetCapabilities) und dann Rückrufe dafür einrichten (mithilfe von IMAPIOfflineMgr::Advise).

Wenn Sie getProcAddress verwenden, um in msmapi32.dll nach der Adresse dieser Funktion zu suchen, geben Sie HrOpenOfflineObj@20 als Prozedurnamen an.

HrOpenOfflineObj funktioniert nur für Clients, bei denen es sich um MAPI-Anbieter, COM-Add-Ins und Exchange-Clienterweiterungen handelt, die innerhalb des Outlook-Prozesses ausgeführt werden. Andernfalls gibt HrOpenOfflineObjMAPI_E_NOT_FOUND zurück.

Siehe auch

IMAPIOffline : IUnknown

IMAPIOfflineMgr : IMAPIOffline

Informationen zur Offlinestatus-API

MAPI-Konstanten