IMessage::GetRecipientTable
Gilt für: Outlook 2013 | Outlook 2016
Gibt die Empfängertabelle der Nachricht zurück.
HRESULT GetRecipientTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parameter
ulFlags
[in] Bitmaske von Flags, die die Rückgabe der Tabelle steuert. Die folgenden Flags können festgelegt werden:
MAPI_DEFERRED_ERRORS
Ermöglicht die erfolgreiche Rückgabe von GetRecipientTable , möglicherweise bevor die Tabelle für den aufrufenden Client vollständig verfügbar ist. Wenn die Tabelle nicht verfügbar ist, kann ein nachfolgendes Aufrufen der Tabelle zu einem Fehler führen.
MAPI_UNICODE
Zeichenfolgenspalten sollten im Unicode-Format vorliegen. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, sollten die Zeichenfolgenspalten im ANSI-Format vorliegen.
lppTable
[out] Zeiger auf einen Zeiger auf die Empfängertabelle.
Rückgabewert
S_OK
Die Empfängertabelle wurde erfolgreich zurückgegeben.
Hinweise
Die IMessage::GetRecipientTable-Methode gibt einen Zeiger auf die Empfängertabelle der Nachricht zurück, die Informationen zu allen Empfängern für die Nachricht enthält. Es gibt eine Zeile für jeden Empfänger.
Empfängertabellen weisen einen anderen Spaltensatz auf, je nachdem, ob die Nachricht gesendet wurde. Eine vollständige Liste der Spalten in einer Empfängertabelle finden Sie unter Empfängertabellen.
Einige Empfängertabellen unterstützen eine Vielzahl von Einschränkungen. andere nicht. Die Unterstützung für Einschränkungen hängt von der Implementierung des Nachrichtenspeicheranbieters ab.
Das Festlegen des MAPI_UNICODE-Flags im ulFlags-Parameter wirkt sich auf die folgenden Aufrufe der Empfängertabelle aus:
IMAPITable::QueryColumns zum Abrufen des Spaltensatzes.
IMAPITable::QueryRows zum Abrufen von Zeilen.
IMAPITable::QuerySortOrder , um die Sortierreihenfolge abzurufen.
Das Festlegen des Unicode-Flags fordert an, dass die Informationen für alle Zeichenfolgenspalten, die von diesen Aufrufen zurückgegeben werden, im Unicode-Format vorliegen. Da jedoch nicht alle Nachrichtenspeicheranbieter Unicode unterstützen, ist das Festlegen dieses Flags nur eine Anforderung.
Hinweise für Aufrufer
Sie können eine Empfängertabelle ändern, während sie geöffnet ist, indem Sie die IMessage::ModifyRecipients-Methode aufrufen. ModifyRecipients fügt Empfänger hinzu, löscht Empfänger oder ändert Empfängereigenschaften.