IMAPIFolder::SetMessageStatus

The IMAPIFolder::SetMessageStatus method sets the status associated with a message  for example, whether that message is marked for deletion.

Quick Info

See IMAPIFolder : IMAPIContainer161AJWS.

HRESULT SetMessageStatus(

Parameters

cbEntryID

[in] Count of bytes in the entry identifier pointed to by the lpEntryID parameter.

lpEntryID

[in] Pointer to the entry identifier for the message whose status is set.

ulNewStatus

[in] New status to be assigned.

ulNewStatusMask

[in] Bitmask of flags that is applied to the new status indicating the flags to be set.

The following flags can be set:

MSGSTATUS_DELMARKED

The message has been marked for deletion.

MSGSTATUS_HIDDEN

The message is not to be displayed.

MSGSTATUS_HIGHLIGHTED

The message is to be displayed as highlighted.

MSGSTATUS_REMOTE_DELETE

The message has been marked for deletion at the remote message store without downloading to the local client.

MSGSTATUS_REMOTE_DOWNLOAD

The message has been marked for downloading from the remote message store to the local client.

MSGSTATUS_TAGGED

The message has been tagged for a client-defined purpose.

lpulOldStatus

[out] Pointer to the previous status of the message.

Return Values

S_OK

The message status was successfully set.

Remarks

The IMAPIFolder::SetMessageStatus method sets the status associated with a message   the value that is stored in its PR_MSG_STATUSTLWKUE property.

Notes to Implementers

How the message status bits are set, cleared, and used depends entirely on your implementation, except that bits 5 through 15 are reserved and must be zero.

Notes to Callers

You can use the PR_MSG_STATUS property of a message to negotiate a message lockout operation with other clients. Designate a bit as the lockout bit. To determine if the lockout bit was set, examine the previous value for message status in the lpulOldStatus parameter. Use the other bits in the ulNewStatus parameter to track message status without interfering with the lockout bit.

See Also