IProviderAdmin::OpenProfileSection
Gilt für: Outlook 2013 | Outlook 2016
Öffnet einen Profilabschnitt aus dem aktuellen Profil 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 eindeutigen Bezeichner für den zu öffnenden Profilabschnitt enthält. Clients dürfen null für den lpUID-Parameter nicht übergeben. Dienstanbieter können NULL übergeben, um die MAPIUID abzurufen, wenn sie von ihren Nachrichtendiensteinstiegspunktfunktionen aufrufen.
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. Das Übergeben von NULL führt dazu, dass die Standardschnittstelle (IProfSect) des Profilabschnitts zurückgegeben wird.
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 die erfolgreiche Rückgabe von OpenProfileSection , möglicherweise bevor der Profilabschnitt für den Aufrufer 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 Objekte mit schreibgeschützter Berechtigung geöffnet, und Aufrufer sollten nicht unter der Annahme funktionieren, dass lese-/schreibberechtigungen erteilt wurden. Clients sind keine Lese-/Schreibberechtigungen für Anbieterabschnitte des Profils zulässig.
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, einen schreibgeschützten Profilabschnitt zu ändern oder auf ein Objekt zuzugreifen, für das der Benutzer über unzureichende Berechtigungen verfügt.
MAPI_E_NOT_FOUND
Der angeforderte Profilabschnitt ist nicht vorhanden.
Hinweise
Die IProviderAdmin::OpenProfileSection-Methode öffnet einen Profilabschnitt, sodass der Aufrufer Informationen aus dem aktiven Profil lesen und möglicherweise Informationen in das aktive Profil schreiben kann.
Clients können mithilfe der OpenProfileSection-Methode keine Profilabschnitte öffnen, die zu Anbietern gehören.
Mehrere Clients oder Dienstanbieter können gleichzeitig einen Profilabschnitt mit schreibgeschützter Berechtigung öffnen. Wenn ein Profilabschnitt jedoch mit Lese-/Schreibberechtigung geöffnet ist, können keine weiteren Aufrufe zum Öffnen des Abschnitts ausgeführt werden, unabhängig von der Art des Zugriffs. Wenn ein Profilabschnitt mit schreibgeschützter Berechtigung geöffnet ist, schlägt ein nachfolgender Aufruf zum Anfordern der Lese-/Schreibberechtigung mit MAPI_E_NO_ACCESS fehl. Wenn ein Abschnitt mit Lese-/Schreibberechtigung geöffnet ist, schlägt auch ein nachfolgender Aufruf zum Anfordern einer schreibgeschützten Berechtigung fehl.
Hinweise für Aufrufer
Wenn Sie anfordern, dass OpenProfileSection einen nicht vorhandenen Profilabschnitt öffnet, indem sie MAPI_MODIFY in ulFlags und eine unbekannte MAPIUID in lpUID übergeben, wird der Profilabschnitt erstellt.
Wenn Sie anfordern, dass OpenProfileSection einen nicht vorhandenen Abschnitt mit schreibgeschützter Berechtigung öffnet, wird MAPI_E_NOT_FOUND zurückgegeben.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIProfileFunctions.cpp |
OpenProfileSection |
MFCMAPI verwendet die IProviderAdmin::OpenProfileSection-Methode , um einen Profilabschnitt aus dem aktuellen Profil zu öffnen. |