IMsgServiceAdmin::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
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 führt dazu, dass ein Zeiger auf die Standardschnittstelle im Parameter lppProfSect zurückgegeben wird. Die Standardschnittstelle für einen Profilabschnitt ist 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 durch einen nachfolgenden Aufruf ein Fehler ausgelöst werden.
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.
MAPI_FORCE_ACCESS
Ermöglicht den Zugriff auf alle Profilabschnitte, auch diejenigen, die sich im Besitz einzelner Dienstanbieter befinden.
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 IMsgServiceAdmin::OpenProfileSection-Methode öffnet einen Profilabschnitt, 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.
OpenProfileSection kann nur zum Öffnen von Profilabschnitten verwendet werden, die sich im Besitz einzelner Dienstanbieter befinden, es sei denn, es wird MAPI_FORCE_ACCESS verwendet.
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.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIProfileFunctions.cpp |
OpenProfileSection |
MFCMAPI verwendet die IMsgServiceAdmin::OpenProfileSection-Methode , um einen Profilabschnitt zu öffnen. |