IProfAdmin::CreateProfile
Gilt für: Outlook 2013 | Outlook 2016
Erstellt ein neues Profil.
HRESULT CreateProfile(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameter
lpszProfileName
[in] Ein Zeiger auf den Namen des neuen Profils.
lpszPassword
[in] Ein Zeiger auf das Kennwort des neuen Profils.
ulUIParam
[in] Ein Handle für das übergeordnete Fenster aller Dialogfelder oder Fenster, die von dieser Methode angezeigt werden.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Profil erstellt wird. Die folgenden Flags können festgelegt werden:
MAPI_APP_PROFILE
MAPI sollte dieses Profil als "App"-Profil erstellen, das die Auffindbarkeit und Interaktionen einschränkt.
Dieses Flag wird möglicherweise nicht in allen MAPI-Implementierungen erkannt oder unterstützt.
MAPI_DEFAULT_SERVICES
MAPI sollte das neue Profil mit den Nachrichtendiensten füllen, die im Abschnitt [Standarddienste] der Datei Mapisvc.inf enthalten sind.
MAPI_DIALOG
Die Konfigurationseigenschaftenblätter der einzelnen Anbieter in den hinzuzufügenden Nachrichtendiensten können angezeigt werden.
Rückgabewert
S_OK
Das neue Profil wurde erstellt.
MAPI_E_NO_ACCESS
Das angegebene neue Profil ist bereits vorhanden.
Hinweise
Die IProfAdmin::CreateProfile-Methode erstellt ein neues Profil.
Hinweise für Aufrufer
Sie können CreateProfile zum Zeitpunkt der Anwendungsinstallation oder jederzeit während einer Sitzung aufrufen. Wenn diese Methode zum Zeitpunkt der Installation aufgerufen wird, stammen viele der Konfigurationseinstellungen aus der Konfigurationsdatei Mapisvc.inf. Wenn diese Methode während einer aktiven Sitzung aufgerufen wird, stammen die Einstellungen vom Benutzer, der durch eine Reihe von Eigenschaftenblättern aufgefordert wird.
Wenn das MAPI_DEFAULT_SERVICES-Flag im ulFlags-Parameter festgelegt ist, ruft CreateProfile die Einstiegspunktfunktion des Nachrichtendiensts für jeden Nachrichtendienst im Abschnitt [Standarddienste] in der Datei Mapisvc.inf auf. Jede Einstiegspunktfunktion des Nachrichtendiensts wird aufgerufen, wobei der ulContext-Parameter auf MSG_SERVICE_CREATE festgelegt ist.
Wenn sowohl das MAPI_DIALOG- als auch das MAPI_DEFAULT_SERVICES-Flags festgelegt sind, werden die Werte in den Parametern ulUIParam und ulFlags ebenfalls an die Einstiegspunktfunktion des Nachrichtendiensts übergeben. Die Einstiegspunktfunktionen des Nachrichtendiensts werden erst aufgerufen, nachdem dem Profil alle verfügbaren Informationen aus der Datei Mapisvc.inf hinzugefügt wurden.
Der Name des neuen Profils und sein Kennwort können 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.
Der lpszPassword-Parameter muss NULL oder ein Zeiger auf eine leere Zeichenfolge sein.
Siehe auch
IMsgServiceAdmin::ConfigureMsgService