ADRLIST
S’applique à : Outlook 2013 | Outlook 2016
Décrit zéro ou plusieurs propriétés qui appartiennent à un ou plusieurs destinataires.
| Valeur | Description |
|---|---|
| Fichier d’en-tête : |
Mapidefs.h |
| Macros associées : |
CbADRLIST, CbNewADRLIST, CbNewADRLIST |
typedef struct _ADRLIST
{
ULONG cEntries;
ADRENTRY aEntries[MAPI_DIM];
} ADRLIST, FAR *LPADRLIST;
Members
cEntries
Nombre d’entrées dans le tableau spécifié par le membre aEntries .
aEntries
Tableau de structures ADRENTRY , une structure pour chaque destinataire.
Remarques
Une structure ADRLIST contient une ou plusieurs structures ADRENTRY , chacune décrivant les propriétés d’un destinataire. Un destinataire peut être non résolu. Cela signifie qu’il ne dispose pas d’un identificateur d’entrée dans son tableau de valeurs de propriété. Un destinataire résolu signifie que la propriété PR_ENTRYID (PidTagEntryId) est incluse. En règle générale, les destinataires résolus ont également une adresse e-mail la propriété PR_EMAIL_ADDRESS (PidTagEmailAddress). Toutefois, l’adresse e-mail n’est pas obligatoire. Les structures ADRLIST sont utilisées, par exemple, pour décrire la liste de destinataires d’un message sortant et par MAPI pour afficher les entrées dans le carnet d’adresses.
Les structures ADRLIST ressemblent aux structures SRowSet utilisées pour représenter des lignes dans des tables. En fait, ces deux structures sont conçues pour pouvoir être utilisées indifféremment. Les deux contiennent un tableau de structures décrivant un groupe de propriétés et un nombre de valeurs dans le tableau. Alors que dans la structure ADRLIST , le tableau contient des structures ADRENTRY , dans la structure SRowSet , le tableau contient des structures SRow . Les structures ADRENTRY et les structures SRow sont identiques dans la disposition. Étant donné que les structures ADRLIST et SRowSet suivent les mêmes règles d’allocation, une structure SRowSet récupérée à partir de la table du contenu d’un conteneur de carnet d’adresses peut être convertie en structure ADRLIST et utilisée telle quelle.
L’illustration suivante montre la disposition d’une structure ADRLIST .
Les parties ADRENTRY et SPropValue d’une structure ADRLIST doivent être allouées et libérées indépendamment des autres parties. Autrement dit, chaque structure SPropValue doit être allouée individuellement une fois que la mémoire de la structure ADRENTRY a été allouée et libérée avant la libération de la structure ADRENTRY . Cette indépendance dans la gestion de la mémoire permet aux destinataires et aux propriétés de destinataires individuels d’être ajoutés ou supprimés librement de la liste d’adresses.
Les fonctions MAPIAllocateBuffer et MAPIFreeBuffer doivent être utilisées pour allouer et libérer la structure ADRLIST et toutes ses parties.
Si une liste de destinataires est trop grande pour tenir en mémoire, les clients peuvent appeler la méthode IMessage ::ModifyRecipients pour travailler avec un sous-ensemble de la liste. Les clients ne doivent pas utiliser les boîtes de dialogue courantes du carnet d’adresses dans cette situation.
Pour plus d’informations sur l’allocation de mémoire pour les structures ADRENTRY , consultez Gestion de la mémoire pour les structures ADRLIST et SRowSet.