ADRLIST
Gilt für: Outlook 2013 | Outlook 2016
Beschreibt null oder mehr Eigenschaften, die zu einem oder mehreren Empfängern gehören.
| Wert | Beschreibung |
|---|---|
| Headerdatei |
Mapidefs.h |
| Verwandte Makros: |
CbADRLIST, CbNewADRLIST, CbNewADRLIST |
typedef struct _ADRLIST
{
ULONG cEntries;
ADRENTRY aEntries[MAPI_DIM];
} ADRLIST, FAR *LPADRLIST;
Members
cEntries
Anzahl der Einträge in dem Array, das vom aEntries-Element angegeben wird.
aEntries
Array von ADRENTRY-Strukturen , eine Struktur für jeden Empfänger.
Hinweise
Eine ADRLIST-Struktur enthält eine oder mehrere ADRENTRY-Strukturen , die jeweils die Eigenschaften eines Empfängers beschreiben. Ein Empfänger kann nicht aufgelöst werden. Dies bedeutet, dass im Array von Eigenschaftswerten kein Eintragsbezeichner vorhanden ist. Ein aufgelöster Empfänger bedeutet, dass die Eigenschaft PR_ENTRYID (PidTagEntryId) enthalten ist. In der Regel verfügen aufgelöste Empfänger auch über eine E-Mail-Adresse mit der Eigenschaft PR_EMAIL_ADDRESS (PidTagEmailAddress). Die E-Mail-Adresse ist jedoch nicht erforderlich. ADRLIST-Strukturen werden beispielsweise verwendet, um die Empfängerliste für eine ausgehende Nachricht zu beschreiben und von MAPI, um die Einträge im Adressbuch anzuzeigen.
ADRLIST-Strukturen ähneln SRowSet-Strukturen , die zum Darstellen von Zeilen in Tabellen verwendet werden. Tatsächlich sind diese beiden Strukturen so konzipiert, dass sie austauschbar verwendet werden können. Beide enthalten ein Array von Strukturen, das eine Gruppe von Eigenschaften und eine Anzahl der Werte im Array beschreibt. Während das Array in der ADRLIST-StrukturADRENTRY-Strukturen enthält, enthält das Array in der SRowSet-StrukturSRow-Strukturen . ADRENTRY-Strukturen und SRow-Strukturen sind im Layout identisch. Da ADRLIST - und SRowSet-Strukturen den gleichen Zuordnungsregeln folgen, kann eine SRowSet-Struktur , die aus der Inhaltstabelle eines Adressbuchcontainers abgerufen wird, in eine ADRLIST-Struktur umgewandelt und unverändert verwendet werden.
Die folgende Abbildung zeigt das Layout einer ADRLIST-Struktur .
Die Teile ADRENTRY und SPropValue in einer ADRLIST-Struktur müssen unabhängig von den anderen Teilen zugeordnet und freigegeben werden. Das heißt, jede SPropValue-Struktur muss einzeln zugeordnet werden, nachdem arbeitsspeicher für die ADRENTRY-Struktur zugewiesen und freigegeben wurde, bevor die ADRENTRY-Struktur freigegeben wird. Diese Unabhängigkeit bei der Verarbeitung des Arbeitsspeichers ermöglicht das freie Hinzufügen oder Löschen von Empfängern und einzelnen Empfängereigenschaften zur Adressliste.
Die Funktionen MAPIAllocateBuffer und MAPIFreeBuffer müssen verwendet werden, um die ADRLIST-Struktur und alle zugehörigen Teile zuzuordnen und frei zu geben.
Wenn eine Empfängerliste zu groß ist, um in den Arbeitsspeicher zu passen, können Clients die IMessage::ModifyRecipients-Methode aufrufen, um mit einer Teilmenge der Liste zu arbeiten. Clients sollten in diesem Fall nicht die allgemeinen Dialogfelder des Adressbuchs verwenden.
Weitere Informationen zum Zuweisen von Arbeitsspeicher für ADRENTRY-Strukturen finden Sie unter Verwalten von Arbeitsspeicher für ADRLIST- und SRowSet-Strukturen.