SERVICEWIZARDDLGPROC
Gilt für: Outlook 2013 | Outlook 2016
Definiert eine Rückruffunktion, die vom Profil-Assistenten aufgerufen wird, damit ein Dienstanbieter auf Benutzerereignisse reagieren kann, wenn die Eigenschaftenblätter oder Seiten des Anbieters angezeigt werden.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiwz.h |
| Definierte Funktion implementiert von: |
Dienstanbieter |
| Definierte Funktion aufgerufen von: |
MAPI-Profil-Assistent |
BOOL SERVICEWIZARDDLGPROC(
HWND hDlg,
UINT wMsgID,
WPARAM wParam,
LPARAM lParam
);
Parameter
hDlg
[in] Fensterhandle zum Dialogfeld Profil-Assistent.
wMsgID
[in] Die zu verarbeitende Fenstermeldung. Zusätzlich zu den regulären Fenstermeldungen, die von einem modalen Dialogfeld erwartet werden, können die folgenden Nachrichten empfangen werden:
WM_CLOSE
Der Profil-Assistent wurde abgeschlossen. Der Dienstanbieter sollte alle erforderlichen Bereinigungen durchführen, z. B. das Aufheben der Zuordnung von dynamisch zugeordnetem Arbeitsspeicher.
WM_COMMAND
Eines der Steuerelemente des Anbieters wurde ausgewählt, oder es wurde auf die Schaltfläche Weiter oder Zurück geklickt. Der Wert im wParam-Parameter gibt an, welches dieser Benutzerereignisse aufgetreten ist.
WM_INITDIALOG
Der Benutzer hat zu einer anderen Eigenschaftenseite gewechselt, für die das Dialogfeld initialisiert werden muss. Der Anbieter sollte die Steuerelemente initialisieren, die der Profil-Assistent dem Dialogfeld hinzugefügt hat.
WIZ_QUERYNUMPAGES
Der Profil-Assistent fordert die Anzahl der Seiten an, die der Anbieter anzeigen muss. Der Anbieter sollte die Anzahl der Seiten anstelle von TRUE oder FALSE zurückgeben. Verwenden Sie beispielsweise die folgende return-Anweisung, um anzugeben, dass drei Seiten angezeigt werden sollen:
return (BOOL)3;
wParam
[in] Ein 32-Bit-Parameter, der Fenstermeldungen zugeordnet ist. Mögliche Werte hängen von der im wMsgID-Parameter angegebenen Nachricht ab. Zusätzlich zu den Werten, die bei den regulären Fenstermeldungen für ein modales Dialogfeld erwartet werden, können die folgenden Werte empfangen werden:
WIZ_NEXT
Wenn wMsgID WM_COMMAND enthält, hat der Benutzer auf die Schaltfläche Weiter geklickt.
WIZ_PREV
Wenn wMsgID WM_COMMAND enthält, hat der Benutzer auf die Schaltfläche Zurück geklickt.
lParam
[in] Ein 32-Bit-Parameter, der Fenstermeldungen zugeordnet ist. Mögliche Werte hängen von der im wMsgID-Parameter angegebenen Nachricht ab.
Rückgabewert
Der von einer SERVICEWIZARDDLGPROC-basierten Funktion zurückgegebene Wert hängt von der empfangenen Fensternachricht ab. Beachten Sie insbesondere den außergewöhnlichen Rückgabewert für die WIZ_QUERYNUMPAGES Nachricht. Die normalen Rückgabewerte sind:
TRUE
Der Dienstanbieter hat die empfangene Fenstermeldung verarbeitet.
FALSE
Der Dienstanbieter hat die empfangene Fensternachricht nicht verarbeitet.
Hinweise
Wenn der Benutzer von einer Eigenschaftenseite zu einer anderen wechselt, ist der Anbieter dafür verantwortlich, die Steuerelemente der alten Seite auszublenden und die Steuerelemente für die nächste oder vorherige Seite anzuzeigen. Wenn der Benutzer auf die Schaltfläche Weiter klickt, wird die SERVICEWIZARDDLGPROC-basierte Funktion mit der WM_COMMAND Meldung und WIZ_NEXT im wParam-Parameter aufgerufen. Die folgenden Schritte beschreiben, was zwischen dem Zeitpunkt passiert, zu dem der Benutzer auf Weiter klickt, und dem Zeitpunkt, zu dem die Konfigurationsseiten des ersten Anbieters gerendert werden.
Der Profil-Assistent blendet alle Steuerelemente aus, die sich im Fenster befinden.
Der Profil-Assistent fügt der Seite die ausgeblendeten Steuerelemente des Anbieters hinzu.
Der Profil-Assistent ruft SERVICEWIZARDDLGPROC auf und sendet die WM_INITDIALOG Nachricht, damit der Anbieter die Steuerelemente initialisieren kann.
Der Profil-Assistent ruft SERVICEWIZARDDLGPROC auf und sendet die WIZ_QUERYNUMPAGES Nachricht. Der Anbieter gibt die Anzahl der Anzuzeigenden Seiten zurück.
Der Profil-Assistent ruft SERVICEWIZARDDLGPROC auf und sendet die WM_COMMAND Nachricht, wobei der wParam-Parameter entweder auf WIZ_NEXT oder WIZ_PREV festgelegt ist. An diesem Punkt gibt der Anbieter entweder FALSE {error} zurück oder zeigt seine Steuerelemente an und gibt TRUE {success} zurück. Wenn der Profil-Assistent ID_NEXT übergibt, wird die erste Seite des Anbieters angezeigt. Wenn ID_PREV übergeben wird, wird die letzte Seite angezeigt.
Der Profil-Assistent ruft die SERVICEWIZARDDLGPROC-Funktion des Anbieters auf und sendet die WM_COMMAND Nachricht, wobei der wParam-Parameter entweder auf WIZ_NEXT oder WIZ_PREV festgelegt ist (je nachdem, auf welche Schaltfläche der Benutzer geklickt hat). Der Anbieter ist dafür verantwortlich, seine Steuerelemente anzuzeigen oder auszublenden und seine Daten in die IMAPIProp zu schreiben, die an den Profil-Assistenten übergeben wird, um die Reihenfolge der Seiten schrittweise zu durchlaufen. Der Anbieter sollte TRUE zurückgeben, wenn die nächste oder vorherige Seite erfolgreich angezeigt wurde, und FALSE, wenn weder die nächste noch die vorherige Seite angezeigt werden konnte. Der Anbieter muss sich dessen bewusst sein, wenn er sich außerhalb seiner Seitensequenz befindet, und entsprechend reagieren, indem er seine Steuerelemente ausblendet und seine Daten in das Profil schreibt.
Wenn der Benutzer außerhalb des Seitenbereichs des Anbieters tritt, löscht der Profil-Assistent die ausgeblendeten Steuerelemente des Anbieters aus dem Dialogfeld und ruft den nächsten Anbieter auf oder zeigt dessen nächste Seite an, wenn dies der letzte Anbieter war.