IAddrBook::Address
S’applique à : Outlook 2013 | Outlook 2016
Affiche la boîte de dialogue carnet d’adresses Outlook.
HRESULT Address(
ULONG_PTR FAR * lpulUIParam,
LPADRPARM lpAdrParms,
LPADRLIST FAR * lppAdrList
);
Paramètres
lpulUIParam
[in, out] Pointeur vers un handle de la fenêtre parente de la boîte de dialogue. Lors de l’entrée, un handle de fenêtre doit toujours être passé. En sortie, si le membre ulFlags du paramètre lpAdrParms est défini sur DIALOG_SDI, le handle de fenêtre de la boîte de dialogue sans mode est retourné. Voir les remarques.
lpAdrParms
[in, out] Pointeur vers une structure ADRPARM qui contrôle la présentation et le comportement de la boîte de dialogue d’adresse.
lppAdrList
[in, out] Pointeur vers un pointeur vers une structure ADRLIST qui contient des informations sur le destinataire. En entrée, ce paramètre peut être NULL ou pointer vers un pointeur valide. Dans la sortie, ce paramètre pointe vers un pointeur vers des informations de destinataire valides.
Valeur renvoyée
S_OK
La boîte de dialogue Adresse commune s’est affichée avec succès.
Remarques
Si le membre ulFlags du paramètre lpAdrParms est défini sur DIALOG_SDI anticipant le retour du handle de fenêtre de la boîte de dialogue sans mode sur la sortie, il est ignoré dans Outlook ; la version modale de la boîte de dialogue est toujours affichée dans les clients non-Outlook.
La structure ADRLIST transmise par MAPI à l’appelant via le paramètre lppAdrList contient un tableau de structures ADRENTRY , une structure pour chaque destinataire. En cas de transmission à la méthode IMessage ::ModifyRecipients d’un message sortant dans le paramètre lpMods , la structure ADRLIST peut être utilisée pour mettre à jour sa liste de destinataires.
Chaque structure ADRENTRY de la structure ADRLIST contient zéro ou plusieurs structures SPropValue , une structure pour chaque jeu de propriétés pour le destinataire. Il peut y avoir zéro structure SPropValue lorsque la boîte de dialogue présentée par la méthode Address est utilisée pour supprimer un destinataire. Lorsqu’il existe une ou plusieurs structures SPropValue , la structure ADRENTRY correspondante est utilisée pour ajouter ou mettre à jour un destinataire. Le destinataire peut être résolu, ce qui indique que l’une des structures SPropValue décrit la propriété PR_ENTRYID (PidTagEntryId) du destinataire, ou non résolue, ce qui indique que la propriété PR_ENTRYID est manquante.
Outre les PR_ENTRYID, les destinataires résolus incluent les propriétés suivantes :
PR_RECIPIENT_TYPE (PidTagRecipientType)
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ADDRTYPE (PidTagAddressType)
PR_DISPLAY_TYPE (PidTagDisplayType)
La structure ADRLIST que l’appelant transmet peut avoir une taille différente de la structure retournée par MAPI. Si MAPI doit retourner une structure ADRLIST plus grande, elle libère la structure d’origine et en alloue une nouvelle. Lorsque vous allouez de la mémoire pour la structure ADRLIST , allouez la mémoire pour chaque structure SPropValue séparément. Pour plus d’informations sur l’allocation et la libération de structures ADRLIST , consultez Gestion de la mémoire pour les structures ADRLIST et SRowSet
Address retourne immédiatement si l’indicateur DIALOG_SDI est défini dans le membre ulFlags de la structure ADRPARM dans le paramètre lpAdrParms . L’indicateur DIALOG_SDI est ignoré pour les clients non-Outlook. Si DIALOG_SDI est ignoré, la version modale de la boîte de dialogue s’affiche et un pointeur vers un handle ne doit pas être attendu dans lpulUIParam.
Address prend en charge les chaînes de caractères Unicode dans la structure ADRPARM si AB_UNICODEUI a été spécifié dans le membre ulFlagsd’ADRPARM dans le paramètre lpAdrParms , et elle prend en charge les chaînes de caractères Unicode dans ADRLIST. Les chaînes Unicode sont converties au format MBCS (multioctet character string) avant d’être affichées dans la boîte de dialogue carnet d’adresses Outlook.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MAPIStoreFunctions.cpp |
OpenOtherUsersMailboxFromGal |
MFCMAPI utilise la méthode Address pour permettre à l’utilisateur de sélectionner la boîte aux lettres à ouvrir. |