IProfAdmin::CreateProfile

Artikel
04/04/2023

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_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: