Partager via


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é.

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. 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 .

Voir aussi

IProfAdmin::GetProfileTable

MAPILogonEx

Propriété canonique PidTagDefaultProfile

IProfAdmin : IUnknown