Partager via

LAUNCHWIZARDENTRY

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Définit une fonction qui démarre l’application Assistant Profil dans le but d’ajouter un ou plusieurs services de messagerie à un profil.

Propriété Valeur
Fichier d’en-tête :
 Mapiwz.h
Fonction définie implémentée par :
 MAPI
Fonction définie appelée par :
 Applications clientes
 
HRESULT LAUNCHWIZARDENTRY(
  HWND hParentWnd,
  ULONG ulFlags,
  LPCSTR FAR * lppszServiceNameToAdd,
  ULONG cbBufferMax,
  LPSTR lpszNewProfileName
);

Paramètres

hParentWnd

[in] Handle de la fenêtre parente de l’appelant. Si l’appelant n’a pas de fenêtre parente, le paramètre hParentWnd doit avoir la valeur NULL.

ulFlags

[in] Masque de bits des indicateurs indiquant les options de l’Assistant Profil. Les indicateurs suivants peuvent être définis :

MAPI_PW_ADD_SERVICE_ONLY

L’Assistant Profil consiste à ajouter uniquement les services de messagerie répertoriés via le paramètre lppszServiceNameToAdd et à ne pas afficher sa page de sélection des services de messagerie.

MAPI_PW_FIRST_PROFILE

Le profil à créer est le premier pour cette station de travail.

MAPI_PW_HIDE_SERVICES_LIST

La page de l’Assistant Profil pour sélectionner les services de messagerie ne doit pas s’afficher.

MAPI_PW_LAUNCHED_BY_CONFIG

L’Assistant Profil a été lancé par l’application de configuration Panneau de configuration.

MAPI_PW_PROVIDER_UI_ONLY

Seules les boîtes de dialogue de configuration des fournisseurs de services doivent être affichées et les pages de l’Assistant Profil ne doivent pas apparaître. Cet indicateur ne peut être défini que si l’indicateur MAPI_PW_ADD_SERVICE_ONLY est défini.

lppszServiceNameToAdd

[in] Pointeur vers un tableau de chaînes qui contient les noms des services de message à ajouter au profil. Le tableau doit se terminer par une valeur NULL.

cbBufferMax

[in] Taille de la mémoire tampon vers laquelle pointe le paramètre lpszNewProfileName .

lpszNewProfileName

[out] Pointeur vers une mémoire tampon de chaîne où la fonction basée sur LAUNCHWIZARDENTRY retourne le nom du profil créé.

Valeur renvoyée

S_OK

L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.

MAPI_E_CALL_FAILED

Une erreur d’origine inattendue ou inconnue a empêché l’opération de se terminer. Les possibilités incluent l’échec de l’initialisation du sous-système MAPI pour l’Assistant Profil, l’impossibilité d’accéder au profil par défaut et un retour d’erreur à partir de la boîte de dialogue.

Remarques

L’implémentation MAPI du prototype de fonction LAUNCHWIZARDENTRY est le point d’entrée dans l’application Assistant Profil MAPI. MAPI nomme ce point d’entrée LaunchWizard.

Lorsque l’indicateur MAPI_PW_ADD_SERVICE_ONLY est défini dans le paramètre ulFlags , les règles suivantes s’appliquent :

  • L’indicateur MAPI_PW_LAUNCHED_BY_CONFIG empêche l’affichage de la page d’accueil.

  • Les indicateurs MAPI_PW_HIDE_SERVICES_LIST et MAPI_PW_PROVIDER_UI_ONLY ne sont utiles que s’il n’y a pas de profil par défaut. Dans ce cas, ces indicateurs déterminent la page de l’Assistant Profil à afficher.

  • S’il existe un profil par défaut, aucune des pages de l’Assistant Profil ne doit être affichée.

  • S’il existe un profil par défaut, un seul service de message est répertorié via le paramètre lppszServiceNameToAdd et ce service de message est déjà dans le profil par défaut, l’Assistant Profil retourne S_OK sans rien ajouter au profil.

Pour chaque service de message à ajouter au profil, l’Assistant Profil appelle la fonction de point d’entrée du service en fonction du prototype MSGSERVICEENTRY . Pour chaque fournisseur de services sélectionné à partir d’un service de messagerie à ajouter au profil, l’Assistant Profil appelle la fonction de point d’entrée du fournisseur en fonction du prototype WIZARDENTRY . Pendant la configuration interactive, chaque événement utilisateur dans les pages de propriétés entraîne l’appel de la fonction de rappel du fournisseur par l’Assistant Profil en fonction du prototype SERVICEWIZARDDLGPROC .

Si un fournisseur de services ajouté au profil prend en charge les pages de l’Assistant Profil, il doit autoriser la configuration programmatique du profil.