Partager via

IProviderAdmin::CreateProvider

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Ajoute un fournisseur de services au service de messagerie.

HRESULT CreateProvider(
  LPSTR lpszProvider,
  ULONG cValues,
  LPSPropValue lpProps,
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  MAPIUID FAR * lpUID
);

Paramètres

lpszProvider

[in] Pointeur vers le nom du fournisseur à ajouter.

cValues

[in] Nombre de valeurs de propriété vers lesquelles pointe le paramètre lpProps .

lpProps

[in] Pointeur vers un tableau de valeurs de propriété qui décrit les propriétés du fournisseur à ajouter.

ulUIParam

[in] Handle de la fenêtre parente de toutes les boîtes de dialogue ou fenêtres affichées par cette méthode. Le paramètre ulUIParam est utilisé si l’indicateur MAPI_DIALOG est défini dans le paramètre ulFlags .

ulFlags

[in] Masque de bits d’indicateurs qui contrôle l’ajout du fournisseur. Les indicateurs suivants peuvent être définis :

  • MAPI_DIALOG : affiche une boîte de dialogue pour demander des informations de configuration.

  • MAPI_UNICODE : le nom du fournisseur et les propriétés de chaîne sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, ces chaînes sont au format ANSI.

lpUID

[out] Pointeur vers la structure MAPIUID qui contient l’identificateur unique qui représente le fournisseur à ajouter.

Valeur renvoyée

S_OK

Le fournisseur a été correctement ajouté au service de messagerie.

MAPI_E_USER_CANCEL

L’utilisateur a annulé l’opération, généralement en cliquant sur le bouton Annuler dans une boîte de dialogue.

Remarques

La méthode IProviderAdmin ::CreateProvider ajoute un fournisseur de services au service de message. Le paramètre lpszProvider doit pointer vers le nom d’un fournisseur qui appartient au service de message. CreateProvider ne vérifie pas si le nom correspond au nom d’un fournisseur dans le service ; si le nom passé ne correspond pas à un nom de service, l’appel réussit, mais les résultats sont imprévisibles. La plupart des services de messagerie n’autorisent pas l’ajout ou la suppression de fournisseurs pendant l’utilisation du profil.

Une fois que toutes les informations disponibles sur le fournisseur de services ont été ajoutées au profil à partir du fichier Mapisvc.inf, CreateProvider appelle la fonction de point d’entrée du service de message avec le paramètre ulContext défini sur MSG_SERVICE_PROVIDER_CREATE. Si MAPI_DIALOG est défini dans le paramètre ulFlags de la méthode CreateProvider, les valeurs des paramètres ulUIParam et ulFlags sont également passées à la fonction de point d’entrée. Ces paramètres supplémentaires permettent au fournisseur de services d’afficher sa feuille de propriétés afin que l’utilisateur puisse entrer les paramètres de configuration.

Voir aussi