IMAPISupport::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,
ULONG ulFlags,
LPPROFSECT FAR * lppProfileObj
);
Parameter
lpUid
[in] Ein Zeiger auf die MAPIUID-Struktur , die den zu öffnenden Profilabschnitt identifiziert. Wenn Null für den lpUid-Parameter übergeben wird, wird der Profilabschnitt des Aufrufers geöffnet.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie der Profilabschnitt geöffnet wird. Die folgenden Flags können festgelegt werden:
MAPI_DEFERRED_ERRORS
Ermöglicht openProfileSection die erfolgreiche Rückgabe, möglicherweise bevor der Profilabschnitt für den Aufrufer vollständig zugänglich ist. Wenn auf den Profilabschnitt nicht zugegriffen werden kann, kann ein nachfolgender Objektaufruf zu einem Fehler führen.
MAPI_MODIFY
Fordert Lese-/Schreibberechtigungen an. Standardmäßig werden Objekte schreibgeschützt geöffnet, und Aufrufer sollten nicht unter der Annahme funktionieren, dass lese-/schreibberechtigungen erteilt wurden.
lppProfileObj
[out] Ein Zeiger auf einen Zeiger auf den geöffneten Profilabschnitt.
Rückgabewert
S_OK
Der Profilabschnitt wurde erfolgreich geöffnet.
MAPI_E_NO_ACCESS
Es wurde versucht, einen schreibgeschützten Profilabschnitt zu ändern oder auf ein Objekt zuzugreifen, für das der Aufrufer über unzureichende Berechtigungen verfügt.
MAPI_E_NOT_FOUND
Dem in lpEntryID übergebenen Eintragsbezeichner ist kein Profilabschnitt zugeordnet.
MAPI_E_UNKNOWN_FLAGS
Reservierte oder nicht unterstützte Flags wurden verwendet, sodass der Vorgang nicht abgeschlossen wurde.
Hinweise
Die IMAPISupport::OpenProfileSection-Methode wird für alle Unterstützungsobjekte implementiert. Dienstanbieter und Nachrichtendienste rufen OpenProfileSection auf, um einen Profilabschnitt zu öffnen und einen Zeiger auf die Implementierung der IProfSect-Schnittstelle abzurufen.
Hinweise für Aufrufer
OpenProfileSection öffnet Profilabschnitte als schreibgeschützt, es sei denn, Sie legen das flag MAPI_MODIFY im ulFlags-Parameter fest und Ihre Berechtigung ist ausreichend. Das Festlegen dieses Flags garantiert keine Lese-/Schreibberechtigung. Welche Berechtigungen Ihnen gewährt werden, hängt von Ihrer Zugriffsebene und dem Objekt ab.
Wenn OpenProfileSection versucht, einen nicht vorhandenen Profilabschnitt schreibgeschützt zu öffnen, wird MAPI_E_NOT_FOUND zurückgegeben. Wenn OpenProfileSection versucht, einen nicht vorhandenen Profilabschnitt als Lese-/Schreibzugriff zu öffnen, wird der Profilabschnitt erstellt und der IProfSect-Zeiger zurückgegeben.