Freigeben über

Behandeln von eingehenden Nachrichten

Gilt für: Outlook 2013 | Outlook 2016

Eine eingehende Nachricht ist eine Nachricht, die über ein oder mehrere Messagingsysteme gesendet wurde. Sie wurde möglicherweise nur an Sie oder viele andere Empfänger gesendet. Eingehende Nachrichten werden in einem Empfangsordner platziert, der zum Speichern von Nachrichten einer bestimmten Klasse bestimmt ist. Sie können einen anderen Empfangsordner für jede von Ihnen verarbeitete Nachrichtenklasse einrichten oder einen Ordner für alle Klassen verwenden.

Wenn Sie sich für neue E-Mail-Benachrichtigungen im Nachrichtenspeicher registriert haben, werden Sie benachrichtigt, wenn eine Nachricht in einem Empfangsordner abgelegt wird. Wenn Sie sich nicht für neue E-Mail-Benachrichtigungen registriert haben, müssen Sie den entsprechenden Empfangsordner in regelmäßigen Abständen öffnen, um manuell zu überprüfen, ob neue Nachrichten eintreffen.

Clients registrieren sich für neue E-Mail-Benachrichtigungen, indem sie die Parameter wie folgt auf IMsgStore::Advise festlegen:

  • Legen Sie cbEntryID auf 0 fest.

  • Legen Sie lpEntryID auf NULL fest.

  • Legen Sie ulEventMask auf fnevNewMail fest.

Der lpNotifications-Parameter im Aufruf Ihrer IMAPIAdviseSink::OnNotify-Methode verweist auf eine NEWMAIL_NOTIFICATION Struktur, die Informationen zur eingehenden Nachricht enthält, z. B. die Nachrichtenklasse, den Eintragsbezeichner, den Eintragsbezeichner des übergeordneten Ordners und den Inhalt der PR_MESSAGE_FLAGS-Eigenschaft . Weitere Informationen zum Registrieren und Behandeln von Benachrichtigungen finden Sie unter IMAPIAdviseSink::OnNotify, NEWMAIL_NOTIFICATION, PR_MESSAGE_FLAGS (PidTagMessageFlags) und Behandeln von Benachrichtigungen.

Ermitteln Sie vor dem Anzeigen einer eingehenden Nachricht für einen Benutzer, ob die Nachrichtenklasse eine Klasse ist, die Ihr Client unterstützt. Wenn dies nicht der Fehler ist, ignorieren Sie die Nachricht. Wenn die Klasse unterstützt wird, können Sie die Nachricht mit einem Formular öffnen und anzeigen, das für die Nachrichtenklasse der Nachricht geeignet ist. Die Auswahl der Formulare basiert auf der Nachrichtenklasse. Nachrichten, die zur IPM-Klasse gehören, verwenden ein standardformular, das von MAPI implementiert wird. Nachrichten, die zu benutzerdefinierten Klassen gehören, die von Clients definiert werden, können entweder clientdefinierte spezialisierte Formulare oder das MAPI-Standardformular verwenden.

Öffnen und Anzeigen einer eingehenden Nachricht

  1. Rufen Sie IMsgStore::GetReceiveFolder auf, um den Eintragsbezeichner des Empfangsordners für die Nachrichtenklasse der Nachricht abzurufen, und übergeben Sie diesen Eintragsbezeichner an IMsgStore::OpenEntry , um den Ordner zu öffnen. Weitere Informationen finden Sie unter IMsgStore::GetReceiveFolder, IMsgStore::OpenEntry und Öffnen eines Nachrichtenspeicherordners.

  2. Rufen Sie die IMAPIContainer::GetContentsTable-Methode des Empfangsordners auf, um die Inhaltstabelle abzurufen. Weitere Informationen finden Sie unter IMAPIContainer::GetContentsTable. Rufen Sie die IMAPITable::QueryRows-Methode der Tabelle auf, um alle Zeilen in der Tabelle abzurufen. Weitere Informationen finden Sie unter IMAPITable::QueryRows und Inhaltstabellen. Weitere Informationen zum Anzeigen einer Inhaltstabelle finden Sie unter Anzeigen einer Ordnerinhaltstabelle.

  3. Wenn Ihr Client interaktiv ist, erlauben Sie es dem Benutzer, eine Nachricht aus der Tabelle auszuwählen, und bestimmen Sie das Formular, das zum Anzeigen dieser Nachricht verwendet werden soll. Clients können das von MAPI bereitgestellte Standardformular oder ein benutzerdefiniertes Formular verwenden. Weitere Informationen finden Sie unter Behandeln von MAPI-Formularen.

  4. Rufen Sie IMsgStore::OpenEntry auf, um die Nachricht zu öffnen. Weitere Informationen finden Sie unter Öffnen einer Nachricht.

  5. Verarbeiten sie den Nachrichtentext. Weitere Informationen finden Sie unter Öffnen des Nachrichtentexts.

  6. Rendern Sie jede der Nachrichtenanlagen. Weitere Informationen finden Sie unter Rendern einer Anlage in Nur-Text oder Rendern einer Anlage in RTF-Text.

  7. Öffnen Sie bei Bedarf eine Anlage. Weitere Informationen finden Sie unter Öffnen einer Anlage.

Inhalt dieses Abschnitts