LAUNCHWIZARDENTRY
Gilt für: Outlook 2013 | Outlook 2016
Definiert eine Funktion, die die Profil-Assistent-Anwendung startet, um einem Profil einen oder mehrere Nachrichtendienste hinzuzufügen.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiwz.h |
| Definierte Funktion implementiert von: |
MAPI |
| Definierte Funktion aufgerufen von: |
Clientanwendungen |
HRESULT LAUNCHWIZARDENTRY(
HWND hParentWnd,
ULONG ulFlags,
LPCSTR FAR * lppszServiceNameToAdd,
ULONG cbBufferMax,
LPSTR lpszNewProfileName
);
Parameter
hParentWnd
[in] Ein Handle für das übergeordnete Fenster des Aufrufers. Wenn der Aufrufer kein übergeordnetes Fenster hat, sollte der hParentWnd-Parameter NULL sein.
ulFlags
[in] Bitmaske von Flags, die Optionen für den Profil-Assistenten angeben. Die folgenden Flags können festgelegt werden:
MAPI_PW_ADD_SERVICE_ONLY
Der Profil-Assistent soll nur die Nachrichtendienste hinzufügen, die über den LppszServiceNameToAdd-Parameter aufgeführt sind, und nicht seine Seite zum Auswählen von Nachrichtendiensten anzeigen.
MAPI_PW_FIRST_PROFILE
Das zu erstellende Profil ist das erste profil für diese Arbeitsstation.
MAPI_PW_HIDE_SERVICES_LIST
Die Seite des Profil-Assistenten zum Auswählen von Nachrichtendiensten sollte nicht angezeigt werden.
MAPI_PW_LAUNCHED_BY_CONFIG
Der Profil-Assistent wurde von der Systemsteuerung-Konfigurationsanwendung gestartet.
MAPI_PW_PROVIDER_UI_ONLY
Es sollten nur die Konfigurationsdialogfelder der Dienstanbieter angezeigt werden, und die Seiten des Profil-Assistenten sollten nicht angezeigt werden. Dieses Flag kann nur festgelegt werden, wenn das flag MAPI_PW_ADD_SERVICE_ONLY festgelegt ist.
lppszServiceNameToAdd
[in] Zeiger auf ein Array von Zeichenfolgen, das die Namen der Nachrichtendienste enthält, die dem Profil hinzugefügt werden sollen. Das Array muss mit einem NULL-Wert beendet werden.
cbBufferMax
[in] Größe des Puffers, auf den der lpszNewProfileName-Parameter verweist.
lpszNewProfileName
[out] Zeiger auf einen Zeichenfolgenpuffer, bei dem die funktion basierend auf LAUNCHWIZARDENTRY den Namen des erstellten Profils zurückgibt.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_CALL_FAILED
Ein Fehler mit unerwartetem oder unbekanntem Ursprung hat den Abschluss des Vorgangs verhindert. Mögliche Optionen sind ein Fehler bei der Initialisierung des MAPI-Subsystems für den Profil-Assistenten, die Unfähigkeit, auf das Standardprofil zuzugreifen, und eine Fehlerrückgabe aus dem Dialogfeld.
Hinweise
Die MAPI-Implementierung des Funktionsprototyps LAUNCHWIZARDENTRY ist der Einstiegspunkt in die MAPI-Profil-Assistent-Anwendung. MAPI benennt diesen Einstiegspunkt als LaunchWizard.
Wenn das MAPI_PW_ADD_SERVICE_ONLY-Flag im ulFlags-Parameter festgelegt ist, gelten die folgenden Regeln:
Das MAPI_PW_LAUNCHED_BY_CONFIG-Flag verhindert, dass die Willkommensseite angezeigt wird.
Die flags MAPI_PW_HIDE_SERVICES_LIST und MAPI_PW_PROVIDER_UI_ONLY sind nur nützlich, wenn kein Standardprofil vorhanden ist. In diesem Fall bestimmen diese Flags, welche Seite des Profil-Assistenten angezeigt werden soll.
Wenn ein Standardprofil vorhanden ist, wird keine der Seiten des Profil-Assistenten angezeigt.
Wenn ein Standardprofil vorhanden ist, wird nur ein Nachrichtendienst über den lppszServiceNameToAdd-Parameter aufgeführt, und dieser Nachrichtendienst befindet sich bereits im Standardprofil, gibt der Profil-Assistent S_OK zurück, ohne dem Profil etwas hinzuzufügen.
Damit jeder Nachrichtendienst dem Profil hinzugefügt wird, ruft der Profil-Assistent die Einstiegspunktfunktion des Diensts basierend auf dem MSGSERVICEENTRY-Prototyp auf. Für jeden Dienstanbieter, der aus einem Nachrichtendienst ausgewählt wurde, der dem Profil hinzugefügt werden soll, ruft der Profil-Assistent die Einstiegspunktfunktion des Anbieters auf der Grundlage des WIZARDENTRY-Prototyps auf. Während der interaktiven Konfiguration bewirkt jedes Benutzerereignis auf den Eigenschaftenseiten, dass der Profil-Assistent die Rückruffunktion des Anbieters basierend auf dem SERVICEWIZARDDLGPROC-Prototyp aufruft .
Wenn ein Dienstanbieter, der dem Profil hinzugefügt wird, die Seiten des Profil-Assistenten unterstützt, muss er die programmgesteuerte Konfiguration des Profils zulassen.