IMAPIFolder::SetMessageStatus
Gilt für: Outlook 2013 | Outlook 2016
Legt die status fest, die einer Nachricht zugeordnet ist (z. B. ob diese Nachricht zum Löschen markiert ist).
HRESULT SetMessageStatus(
ULONG cbEntryID,
LPENTRYID lpEntryID,
ULONG ulNewStatus,
ULONG ulNewStatusMask,
ULONG FAR * lpulOldStatus
);
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 festgelegt ist.
ulNewStatus
[in] Die neue status, die zugewiesen werden soll.
ulNewStatusMask
[in] Eine Bitmaske von Flags, die auf die neue status angewendet wird und die festzulegenden Flags angibt. 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.
lpulOldStatus
[out] Ein Zeiger auf den vorherigen status der Nachricht.
Rückgabewert
S_OK
Die Meldung status erfolgreich festgelegt wurde.
Hinweise
Die IMAPIFolder::SetMessageStatus-Methode legt die Nachricht status auf den Wert fest, der in der eigenschaft PR_MSG_STATUS (PidTagMessageStatus) gespeichert ist.
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.
Die Implementierung dieser Methode durch einen Remotetransportanbieter muss der hier beschriebenen Semantik entsprechen. Es gibt keine besonderen Überlegungen. Clients verwenden diese Methode, um die MSGSTATUS_REMOTE_DOWNLOAD und MSGSTATUS_REMOTE_DELETE Bits festzulegen, um anzugeben, dass eine bestimmte Nachricht aus dem Remotenachrichtenspeicher heruntergeladen oder gelöscht werden soll. Ein Remotetransportanbieter muss die zugehörige IMAPIFolder::GetMessageStatus-Methode nicht implementieren. Clients müssen in der Inhaltstabelle des Ordners suchen, um die status einer Nachricht zu bestimmen.
Hinweise für Aufrufer
Sie können die PR_MSG_STATUS-Eigenschaft einer Nachricht verwenden, um einen Nachrichtensperrvorgang mit anderen Clients auszuhandeln. Legen Sie ein Bit als Sperrbit fest. Um zu bestimmen, ob das Lockout-Bit festgelegt wurde, überprüfen Sie den vorherigen Wert für message status im lpulOldStatus-Parameter. Verwenden Sie die anderen Bits im ulNewStatus-Parameter, um Nachrichten status nachzuverfolgen, ohne das Sperrbit zu beeinträchtigen.