WIZARDENTRY

S’applique à : Outlook 2013 | Outlook 2016

Définit une fonction de point d’entrée de fournisseur de services que l’Assistant Profil appelle pour récupérer suffisamment d’informations pour afficher les feuilles de propriétés de configuration du fournisseur.

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

Paramètres

hProviderDLLInstance

[in] Handle d’instance de la DLL du fournisseur de services.

lpcsResourceName

[out] Pointeur vers une chaîne qui contient le nom complet de la ressource de boîte de dialogue qui doit être affichée par l’Assistant Profil pendant la configuration. La taille maximale de la chaîne, y compris la marque de fin NULL, est de 32 caractères.

lppDlgProc

[out] Pointeur vers une procédure de boîte de dialogue Windows standard qui sera appelée par l’Assistant Profil pour informer le fournisseur de divers événements.

lpMAPIProp

[in] Pointeur vers une implémentation d’interface de propriété qui fournit l’accès aux propriétés de configuration.

lpMapiSupportObject

[in] Pointeur vers l’objet de prise en charge MAPI applicable à cette session.

Valeur renvoyée

S_OK

La fonction WIZARDENTRY du fournisseur de services a été appelée avec succès.

MAPI_E_CALL_FAILED

Une erreur d’origine inattendue ou inconnue a empêché l’opération de se terminer.

Remarques

L’Assistant Profil appelle la fonction basée sur WIZARDENTRY lorsqu’elle est prête à afficher l’interface utilisateur de configuration du fournisseur de services. Lorsque l’Assistant Profil a terminé de configurer tous les fournisseurs, il écrit les propriétés de configuration dans le profil en appelant IMsgServiceAdmin ::ConfigureMsgService.

Remarques pour les responsables de l’implémentation

Le nom de la fonction basée sur WIZARDENTRY doit être placé dans l’entrée WIZARD_ENTRY_NAME dans MAPISVC.INF.

Le nom de la ressource est celui de la ressource de boîte de dialogue qui sera affichée dans le volet de l’Assistant Profil. La ressource qui est transmise doit contenir toutes les pages dans une seule ressource de dialogue. Lorsque l’Assistant Profil reçoit cette ressource, il ignore le style de boîte de dialogue, mais pas les styles de contrôle, et crée tous les contrôles en tant qu’enfants de la page Assistant Profil. Tous les contrôles sont initialement masqués. Les fournisseurs doivent s’assurer que les coordonnées de leurs contrôles sont de base zéro ou zéro, et qu’ils ne dépassent pas une largeur maximale de 200 unités de dialogue et une hauteur maximale de 150 unités de dialogue. Les identificateurs de contrôle inférieurs à 400 sont réservés à l’Assistant Profil. L’Assistant Profil affiche le titre du fournisseur en gras au-dessus de l’interface utilisateur du fournisseur.

Le pointeur d’interface de propriété fourni dans le paramètre lpMAPIProp doit être conservé par le fournisseur pour référence ultérieure. L’Assistant Profil traite uniquement l’ensemble de propriétés le plus simple, et le fournisseur peut utiliser l’implémentation de l’interface de propriété pour inclure des propriétés supplémentaires. Pendant la configuration, les fournisseurs doivent ajouter leurs propriétés de configuration à l’objet implémentant l’interface de propriété. Une fois tous les fournisseurs configurés, l’Assistant Profil ajoute ces propriétés au profil.

Pour plus d’informations sur l’utilisation de cette fonction, consultez Prise en charge de la configuration du service de message.