IAddrBook::GetDefaultDir
S’applique à : Outlook 2013 | Outlook 2016
Retourne l’identificateur d’entrée du conteneur de carnet d’adresses initial.
HRESULT GetDefaultDir(
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
Paramètres
lpcbEntryID
[out] Pointeur vers le nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lppEntryID .
lppEntryID
[out] Pointeur vers un pointeur vers l’identificateur d’entrée du conteneur par défaut.
Valeur renvoyée
S_OK
L’identificateur d’entrée du conteneur par défaut a été retourné avec succès.
Remarques
Les applications clientes et les fournisseurs de services appellent la méthode GetDefaultDir pour récupérer l’identificateur d’entrée du conteneur de carnet d’adresses par défaut. Le conteneur par défaut est ce que l’utilisateur voit affiché dans le carnet d’adresses lors de la première ouverture du carnet d’adresses. Si un conteneur par défaut n’a pas été défini par un appel à la méthode IAddrBook ::SetDefaultDir , MAPI affecte comme conteneur par défaut le premier conteneur avec des noms qui ne sont pas le carnet d’adresses personnel (PAB). Si un tel conteneur est introuvable, le PAB devient le conteneur par défaut.
Pour définir le répertoire par défaut, un client ou un fournisseur appelle la méthode SetDefaultDir . Les clients et les fournisseurs n’ont pas besoin d’appeler la méthode IMAPIProp ::SaveChanges ; étant donné que les modifications apportées au carnet d’adresses ne sont pas traitées, les modifications sont immédiatement rendues permanentes.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
Fichier | Fonction | Commentaire |
---|---|---|
MainDlg.cpp |
CMainDlg ::OnOpenDefaultDir |
MFCMAPI utilise la méthode GetDefaultDir pour obtenir l’ID du conteneur de carnet d’adresses par défaut. |