MapiRecipDesc-Struktur (mapi.h)

Artikel
08/24/2023

Eine MapiRecipDesc-Struktur enthält Informationen zu einem Nachrichtensender oder -empfänger. Verwenden Sie für Unicode-Unterstützung die MapiRecipDescW-Struktur .

Syntax

typedef struct {
  ULONG  ulReserved;
  ULONG  ulRecipClass;
  LPSTR  lpszName;
  LPSTR  lpszAddress;
  ULONG  ulEIDSize;
  LPVOID lpEntryID;
} MapiRecipDesc, *lpMapiRecipDesc;

Members

ulReserved

Reserviert; muss null sein.

ulRecipClass

Enthält einen numerischen Wert, der den Typ des Empfängers angibt. Mögliche Werte sind wie folgt.

Wert	Bedeutung
MAPI_ORIG 0	Gibt den ursprünglichen Absender der Nachricht an.
MAPI_TO 1	Gibt einen primären Nachrichtenempfänger an.
MAPI_CC 2	Gibt einen Empfänger einer Nachrichtenkopie an.
MAPI_BCC 3	Gibt einen Empfänger einer Blindkopie an.

lpszName

Zeiger auf den Anzeigenamen des Nachrichtenempfängers oder -absenders.

lpszAddress

Optionaler Zeiger auf die Adresse des Empfängers oder Absenders; Bei dieser Adresse handelt es sich um anbieterspezifische Nachrichtenübermittlungsdaten. Im Allgemeinen stellt das Messagingsystem solche Adressen für eingehende Nachrichten bereit. Bei ausgehenden Nachrichten kann das lpszAddress-Element auf eine Adresse verweisen, die vom Benutzer für einen Empfänger eingegeben wurde, der sich nicht in einem Adressbuch befindet (d. r. einen benutzerdefinierten Empfänger).

Das Format der Adresse ist Adresstyp:E-Mail-Adresse. Beispiele für gültige Adressen sind FAX:206-555-1212 und SMTP:M@X.COM.

ulEIDSize

Die Größe des Eintragsbezeichners in Bytes, auf die vom lpEntryID-Member verwiesen wird.

lpEntryID

Zeiger auf einen undurchsichtigen Eintragsbezeichner, der von einem Messagingsystemdienstanbieter verwendet wird, um den Nachrichtenempfänger zu identifizieren. Eingabebezeichner haben nur für den Dienstanbieter Bedeutung. Clientanwendungen können sie nicht entschlüsseln. Das Messagingsystem verwendet diesen Member, um gültige Eingabebezeichner für alle im Adressbuch aufgeführten Empfänger oder Absender zurückzugeben.