IMAPIFolder::GetMessageStatus
Gilt für: Outlook 2013 | Outlook 2016
Ruft die status ab, die einer Nachricht in einem bestimmten Ordner zugeordnet ist (z. B. ob diese Nachricht zum Löschen markiert ist).
HRESULT GetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulFlags,
ULONG FAR * lpulMessageStatus
);
Parameter
cbEntryID
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEntryID-Parameter verweist.
lpEntryID
[in] Ein Zeiger auf den Eintragsbezeichner für die Nachricht, deren status abgerufen wird.
ulFlags
[in] Reserviert. NULL muss sein.
lpulMessageStatus
[out] Ein Zeiger auf einen Zeiger auf eine Bitmaske von Flags, die die status der Nachricht angeben. Die Bits 0 bis 15 sind reserviert und müssen null sein. Die Bits 16 bis 31 sind für die implementierungsspezifische Verwendung verfügbar. Die folgenden Flags können festgelegt werden:
MSGSTATUS_DELMARKED
Die Nachricht wurde zum Löschen markiert.
MSGSTATUS_HIDDEN
Die Meldung soll nicht angezeigt werden.
MSGSTATUS_HIGHLIGHTED
Die Meldung soll hervorgehoben angezeigt werden.
MSGSTATUS_REMOTE_DELETE
Die Nachricht wurde im Remotenachrichtenspeicher zum Löschen markiert, ohne auf den lokalen Client heruntergeladen zu werden.
MSGSTATUS_REMOTE_DOWNLOAD
Die Nachricht wurde zum Herunterladen aus dem Remotenachrichtenspeicher auf den lokalen Client markiert.
MSGSTATUS_TAGGED
Die Nachricht wurde für einen vom Client definierten Zweck markiert.
Rückgabewert
S_OK
Die Nachricht status erfolgreich abgerufen wurde.
Hinweise
Die IMAPIFolder::GetMessageStatus-Methode gibt die status einer Nachricht zurück. Message status wird in der eigenschaft PR_MSG_STATUS (PidTagMessageStatus) der Nachricht gespeichert.
Hinweise für Implementierer
Wie die Nachricht status Bits festgelegt, gelöscht und verwendet wird, hängt vollständig von Ihrer Implementierung ab, mit der Ausnahme, dass die Bits 0 bis 15 reserviert sind und null sein müssen. Wenn Sie Nachrichten in der IPM-Unterstruktur speichern, reserviert MAPI die Bits 16 bis 31 für die Verwendung durch IPM-Clients. Wenn Sie Nachrichten in anderen Unterstrukturen speichern, können Sie die Bits 16 bis 31 für Ihre eigenen Zwecke verwenden.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetNextMessage |
MFCMAPI verwendet die IMAPIFolder::GetMessageStatus-Methode, um die status der nächsten anzuzeigenden Nachricht abzurufen. |
| MAPIFormFunctions.cpp |
OpenMessageNonModal und OpenMessageModal |
MFCMAPI verwendet die IMAPIFolder::GetMessageStatus-Methode, um die status der anzuzeigenden Nachricht abzurufen, die an den Formular-Viewer übergeben werden soll, der entweder CMyMAPIFormViewer oder IMAPISession::ShowForm ist. |