IAddrBook::SetDefaultDir
S’applique à : Outlook 2013 | Outlook 2016
Établit le conteneur spécifié comme conteneur de carnet d’adresses par défaut.
HRESULT SetDefaultDir(
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Paramètres
cbEntryID
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpEntryID .
lpEntryID
[in] Pointeur vers l’identificateur d’entrée du conteneur de carnet d’adresses par défaut.
Valeur renvoyée
S_OK
Le conteneur de carnet d’adresses par défaut a été correctement défini.
Remarques
Les clients et les fournisseurs de services appellent la méthode SetDefaultDir pour établir un nouveau conteneur de carnet d’adresses par défaut. Le conteneur par défaut est le conteneur que l’utilisateur voit affiché dans le carnet d’adresses lors de la première ouverture du carnet d’adresses. SetDefaultDir enregistre le conteneur par défaut en tant qu’entrée dans le profil. Le conteneur reste le conteneur par défaut jusqu’à ce qu’un autre appel à SetDefaultDir soit effectué dans la même session ou dans une autre session, soit jusqu’à ce que le conteneur soit supprimé.
Remarque
La propriété PR_AB_CHOOSE_DIRECTORY_AUTOMATICALLY correspond au paramètre Choisir automatiquement dans la boîte de dialogue Options du carnet d’adresses. Lorsque cette propriété existe dans la section de profil IID_CAPONE_PROF et qu’elle a la valeur true, la boîte de dialogue Carnet d’adresses n’utilise plus par défaut le conteneur spécifié par SetDefaultDir, mais choisit un carnet d’adresses que Microsoft Outlook considère comme approprié pour le contexte dans lequel la boîte de dialogue a été affichée. Notez que cela peut entraîner une expérience médiocre pour les fournisseurs de carnets d’adresses tiers.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| Abcontdlg.cpp |
CAbContDlg ::OnSetDefaultDir |
MFCMAPI utilise la méthode SetDefaultDir pour faire du conteneur de carnet d’adresses spécifié le conteneur par défaut. |