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
IMAPIOfflineMgr : IMAPIOffline