IProfAdmin::AdminServices
Gilt für: Outlook 2013 | Outlook 2016
Bietet Zugriff auf ein Nachrichtendienstverwaltungsobjekt, um Änderungen an den Nachrichtendiensten in einem Profil vorzunehmen.
HRESULT AdminServices(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPSERVICEADMIN FAR * lppServiceAdmin
);
Parameter
lpszProfileName
[in] Ein Zeiger auf den Namen des zu ändernden Profils. Der lpszProfileName-Parameter darf nicht NULL sein.
lpszPassword
[in] Immer NULL.
ulUIParam
[in] Ein Handle des übergeordneten Fensters für alle Dialogfelder oder Fenster, die von dieser Methode angezeigt werden.
ulFlags
[in] Eine Bitmaske von Flags, die den Abruf des Nachrichtendienstverwaltungsobjekts steuert. Die folgenden Flags können festgelegt werden:
MAPI_DIALOG
Ermöglicht die Anzeige einer Benutzeroberfläche.
MAPI_UNICODE
Der Profilname weist das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, hat der Name das ANSI-Format.
lppServiceAdmin
[out] Ein Zeiger auf einen Zeiger auf ein Nachrichtendienst-Verwaltungsobjekt.
Rückgabewert
S_OK
Das Verwaltungsobjekt des Nachrichtendiensts wurde erfolgreich zurückgegeben.
MAPI_E_LOGON_FAILED
Das angegebene Profil ist nicht vorhanden, oder das Kennwort war falsch, und ein Dialogfeld konnte dem Benutzer nicht angezeigt werden, um das richtige Kennwort anzufordern, da MAPI_DIALOG in ulFlags nicht festgelegt wurde.
MAPI_E_USER_CANCEL
Der Benutzer hat den Vorgang in der Regel abgebrochen, indem er in einem Dialogfeld auf die Schaltfläche Abbrechen geklickt hat.
Hinweise
Die IProfAdmin::AdminServices-Methode bietet Zugriff auf ein Nachrichtendienst-Verwaltungsobjekt, um Konfigurationsänderungen an den Nachrichtendiensten in einem Profil vorzunehmen.
Der lpszPassword-Parameter muss NULL oder ein Zeiger auf eine leere Zeichenfolge sein.
Hinweise für Aufrufer
Obwohl Sie einen IMsgServiceAdmin-Zeiger abrufen können, indem Sie entweder diese Methode oder IMAPISession::AdminServices aufrufen, rufen Sie IProfAdmin::AdminServices auf, wenn Sie ausschließlich über einen Konfigurationsclient verfügen und keine Messagingfunktionen anbieten. IProfAdmin::AdminServices erstellt kein Sitzungsobjekt und lädt keine Dienstanbieter, wodurch die Leistung verbessert wird.
Sie können IProfAdmin::AdminServices nicht zum Erstellen eines Profils verwenden. Daher müssen Sie ein vorhandenes gültiges Profil in lpszProfileName angeben. Wenn das angegebene Profil nicht vorhanden ist, gibt IProfAdmin::AdminServices MAPI_E_LOGON_FAILED zurück.
Der Name des Profils kann bis zu 64 Zeichen lang sein und die folgenden Zeichen enthalten:
Alle alphanumerischen Zeichen, einschließlich Akzentzeichen und Unterstrich.
Eingebettete Leerzeichen, aber keine führenden oder nachfolgenden Leerzeichen.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI verwendet die IProfAdmin::AdminServices-Methode , um ein Nachrichtendienstverwaltungsobjekt für das ausgewählte Profil zum Hinzufügen von Diensten zu öffnen. |