WIZARDENTRY

Gilt für: Outlook 2013 | Outlook 2016

Definiert eine Dienstanbietereinstiegspunktfunktion, die der Profil-Assistent aufruft, um genügend Informationen abzurufen, um die Konfigurationseigenschaftenblätter des Anbieters anzuzeigen.

Eigenschaft	Wert
Headerdatei	Mapiwz.h
Definierte Funktion implementiert von:	Dienstanbieter
Definierte Funktion aufgerufen von:	MAPI-Profil-Assistent

ULONG WIZARDENTRY(
  HINSTANCE hProviderDLLInstance,
  LPSTR FAR * lpcsResourceName,
  DLGPROC FAR * lppDlgProc,
  LPMAPIPROP lpMAPIProp,
  LPMAPISUPPORTOBJECT lpMapiSupportObject
);

Parameter

hProviderDLLInstance

[in] Instanzhandle der DLL des Dienstanbieters.

lpcsResourceName

[out] Zeiger auf eine Zeichenfolge, die den vollständigen Namen der Dialogressource enthält, die während der Konfiguration vom Profil-Assistenten angezeigt werden soll. Die maximale Größe der Zeichenfolge, einschließlich des NULL-Abschlusszeichens, beträgt 32 Zeichen.

lppDlgProc

[out] Zeiger auf eine Standardmäßige Windows-Dialogfeldprozedur, die vom Profil-Assistenten aufgerufen wird, um den Anbieter über verschiedene Ereignisse zu benachrichtigen.

lpMAPIProp

[in] Zeiger auf eine Eigenschaftenschnittstellenimplementierung, die Zugriff auf die Konfigurationseigenschaften ermöglicht.

lpMapiSupportObject

[in] Zeiger auf das MAPI-Unterstützungsobjekt, das für diese Sitzung gilt.

Rückgabewert

S_OK

Die WIZARDENTRY-Funktion des Dienstanbieters wurde erfolgreich aufgerufen.

MAPI_E_CALL_FAILED

Ein Fehler mit unerwartetem oder unbekanntem Ursprung hat den Abschluss des Vorgangs verhindert.

Hinweise

Der Profil-Assistent ruft die WIZARDENTRY-basierte Funktion auf, wenn er bereit ist, die Konfigurations-Benutzeroberfläche des Dienstanbieters anzuzeigen. Wenn der Profil-Assistent die Konfiguration aller Anbieter abgeschlossen hat, schreibt er die Konfigurationseigenschaften in das Profil, indem er IMsgServiceAdmin::ConfigureMsgService aufruft.

Hinweise für Implementierer

Der Name der WIZARDENTRY-basierten Funktion muss im eintrag WIZARD_ENTRY_NAME in MAPISVC.INF platziert werden.

Der Ressourcenname ist der der Dialogressource, die im Bereich des Profil-Assistenten gerendert wird. Die ressource, die zurückgegeben wird, muss alle Seiten in einer einzelnen Dialogressource enthalten. Wenn der Profil-Assistent diese Ressource empfängt, ignoriert er das Dialogfeldformat, aber nicht die Steuerelementstile, und erstellt alle Steuerelemente als untergeordnete Elemente der Seite Profil-Assistent. Alle Steuerelemente sind anfänglich ausgeblendet. Anbieter sollten sicherstellen, dass die Koordinaten für ihre Steuerelemente null oder nullbasiert sind und dass sie eine maximale Breite von 200 Dialogeinheiten und eine maximale Höhe von 150 Dialogeinheiten nicht überschreiten. Steuerbezeichner unter 400 sind für den Profil-Assistenten reserviert. Der Profil-Assistent zeigt den Titel des Anbieters fett über der Benutzeroberfläche des Anbieters an.

Der im lpMAPIProp-Parameter angegebene Eigenschaftenschnittstellenzeiger sollte vom Anbieter für zukünftige Verweise beibehalten werden. Der Profil-Assistent behandelt nur den grundlegendsten Satz von Eigenschaften, und der Anbieter kann die Implementierung der Eigenschaftenschnittstelle verwenden, um zusätzliche Eigenschaften einzuschließen. Während der Konfiguration sollten Anbieter ihre Konfigurationseigenschaften dem Objekt hinzufügen, das die Eigenschaftenschnittstelle implementiert. Nachdem alle Anbieter konfiguriert wurden, fügt der Profil-Assistent diese Eigenschaften dem Profil hinzu.

Weitere Informationen zur Verwendung dieser Funktion finden Sie unter Unterstützung der Nachrichtendienstkonfiguration.