ADRENTRY

S’applique à : Outlook 2013 | Outlook 2016

Décrit zéro ou plusieurs propriétés qui appartiennent à un destinataire.

typedef struct _ADRENTRY
{
  ULONG ulReserved1;
  ULONG cValues;
  LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;

Members

ulReserved1

Réservés au; doit être égal à zéro.

cValues

Nombre de propriétés dans le tableau de valeurs de propriété vers lequel pointe le membre rgPropVals . Le membre cValues peut être égal à zéro.

rgPropVals

Pointeur vers un tableau de valeurs de propriété décrivant les propriétés du destinataire. Le membre rgPropVals peut être NULL.

Remarques

Une structure ADRENTRY décrit les propriétés qui appartiennent à un seul destinataire. Les propriétés généralement utilisées pour décrire un destinataire sont les suivantes :

PR_DISPLAY_NAME (PidTagDisplayName)

PR_ADDRTYPE (PidTagAddressType)

PR_EMAIL_ADDRESS (PidTagEmailAddress)

PR_ENTRYID (PidTagEntryId)

Lorsqu’un identificateur d’entrée ou une propriété PR_ENTRYID s’affiche dans le tableau SPropValue pour un destinataire, cela indique que le destinataire a été résolu. Les clients appellent la méthode IAddrBook ::ResolveName pour s’assurer que tous les destinataires de la liste des destinataires d’un message sortant ont été résolus. Seuls les destinataires résolus peuvent être envoyés avec des messages.

Les structures ADRENTRY sont généralement combinées pour former un tableau pour le membre aEntries d’une structure ADRLIST.

Les structures ADRENTRY et SRow sont identiques, car elles contiennent un membre réservé, un tableau de valeurs de propriété et un nombre de valeurs dans le tableau. Alors que les structures ADRENTRY sont combinées pour former le membre aEntries d’une structure ADRLIST , les structures SRow sont combinées pour former le membre aRow d’une structure SRowSet . Les deux types de structures suivent les mêmes règles d’allocation, ce qui implique qu’une structure SRowSet récupérée à partir de la table de contenu d’un conteneur de carnet d’adresses peut être convertie en structure ADRLIST et utilisée telle quelle.

Une structure ADRENTRY peut être vide. Par exemple, une structure ADRENTRY contenue dans la structure ADRLIST pointée par le paramètre lppAdrList dans un appel à IAddrBook ::Address peut être vide lorsqu’un destinataire est supprimé.

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.

Voir aussi

IAddrBook::Address
IMessage::ModifyRecipients
MAPIAllocateBuffer
ADRLIST
SRow
Structures MAPISRowSet