IMAPISession::OpenProfileSection
Gilt für: Outlook 2013 | Outlook 2016
Öffnet einen Abschnitt des aktuellen Profils und gibt einen IProfSect-Zeiger für weiteren Zugriff zurück.
HRESULT OpenProfileSection(
LPMAPIUID lpUID,
LPCIID lpInterface,
ULONG ulFlags,
LPPROFSECT FAR * lppProfSect
);
Parameter
lpUID
[in] Ein Zeiger auf die MAPIUID-Struktur , die den Profilabschnitt identifiziert.
lpInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf den Profilabschnitt verwendet werden soll. Die Übergabe von NULL bewirkt, dass der lppProfSect-Parameter einen Zeiger auf die Standardschnittstelle des Profilabschnitts zurückgibt, IProfSect.
ulFlags
[in] Eine Bitmaske von Flags, die den Zugriff auf den Profilabschnitt steuert. Die folgenden Flags können festgelegt werden:
MAPI_DEFERRED_ERRORS
Ermöglicht die erfolgreiche Rückgabe von OpenProfileSection , möglicherweise bevor der Profilabschnitt für den aufrufenden Client vollständig verfügbar ist. Wenn der Profilabschnitt nicht verfügbar ist, kann ein späterer Aufruf einen Fehler verursachen.
MAPI_FORCE_ACCESS
Ermöglicht den Zugriff auf einen Profilabschnitt, der nicht zum Anbieter gehört.
MAPI_MODIFY
Fordert Lese-/Schreibberechtigungen an. Standardmäßig werden Profilabschnitte mit schreibgeschützter Berechtigung geöffnet, und Clients sollten nicht unter der Annahme funktionieren, dass lese-/schreibberechtigungen erteilt wurden.
lppProfSect
[out] Ein Zeiger auf einen Zeiger auf den Profilabschnitt.
Rückgabewert
S_OK
Der Profilabschnitt wurde erfolgreich geöffnet.
MAPI_E_NO_ACCESS
Es wurde versucht, auf einen Profilabschnitt zuzugreifen, für den der Aufrufer über unzureichende Berechtigungen verfügt.
MAPI_E_NOT_FOUND
Der angeforderte Profilabschnitt ist nicht vorhanden.
Hinweise
Die IMAPISession::OpenProfileSection-Methode öffnet einen Profilabschnitt oder ein Objekt, das die IProfSect-Schnittstelle unterstützt. Profilabschnitte werden zum Lesen von Informationen aus dem Sitzungsprofil und zum Schreiben von Informationen in das Sitzungsprofil verwendet.
Sie können OpenProfileSection nur verwenden, um Profilabschnitte zu öffnen, die sich im Besitz einzelner Dienstanbieter befinden, es sei denn, Sie geben MAPI_FORCE_ACCESS im ulFlags-Parameter an.
Hinweise für Aufrufer
Mehrere Clients können einen Profilabschnitt mit schreibgeschützter Berechtigung öffnen, aber nur ein Client kann einen Profilabschnitt mit Lese-/Schreibberechtigung öffnen. Wenn auf einem anderen Client ein Profilabschnitt geöffnet ist, den Sie durch Aufrufen von OpenProfileSection mit festgelegtem MAPI_MODIFY-Flag öffnen möchten, schlägt der Aufruf fehl und gibt MAPI_E_NO_ACCESS zurück.
Ein schreibgeschützter Öffnenvorgang schlägt fehl, wenn der Abschnitt zum Schreiben geöffnet ist.
Sie können einen Profilabschnitt erstellen, indem Sie OpenProfileSection mit dem flag MAPI_MODIFY und einer nicht vorhandenen MAPIUID-Struktur im lpUID-Parameter aufrufen. Stellen Sie sicher, dass Sie MAPI_MODIFY angeben. Wenn Sie lpUID so festlegen, dass es auf eine nicht vorhandene MAPIUID verweist und OpenProfileSection so festgelegt ist, dass der Standardzugriffsmodus schreibgeschützt verwendet wird, schlägt der Aufruf mit MAPI_E_NOT_FOUND fehl.If you set set to point to a nonexistent MAPIUID and OpenProfileSection is set to use the default access mode of read-only, the call will fail with MAPI_E_NOT_FOUND.