IProfAdmin::SetDefaultProfile
S’applique à : Outlook 2013 | Outlook 2016
Définit ou efface le profil par défaut d’un client.
HRESULT SetDefaultProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Paramètres
lpszProfileName
[in] Pointeur vers le nom du profil qui deviendra la valeur par défaut, ou NULL. La définition de lpszProfileName sur NULL indique que SetDefaultProfile doit supprimer le profil par défaut existant, ce qui laisse le client sans valeur par défaut.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type de la chaîne pointée par lpszProfileName. L’indicateur suivant peut être défini :
MAPI_UNICODE
Le nom du profil est au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, le nom du profil est au format ANSI.
Valeur renvoyée
S_OK
Un profil par défaut a été correctement établi ou supprimé.
E_FAIL
Le profil spécifié ne peut pas être défini comme profil par défaut.
MAPI_E_NOT_FOUND
Le profil spécifié n’existe pas.
Remarques
La méthode IProfAdmin ::SetDefaultProfile établit un profil particulier comme profil par défaut du client ou efface le profil par défaut actuel. Un profil « application » ne peut pas être défini comme profil par défaut. Le profil par défaut est le profil qui est utilisé automatiquement chaque fois que le client commence une session MAPI. SetDefaultProfile définit également la propriété PR_DEFAULT_PROFILE (PidTagDefaultProfile) du nouveau profil par défaut sur TRUE.
Remarques pour les appelants
Pour démarrer une session avec le profil par défaut, transmettez l’indicateur MAPI_USE_DEFAULT à la fonction MAPILogonEx .