Share via

IMAPIMessageSite::GetSiteStatus

  • Article

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Returns information from a message site object about the message site's capabilities for the current message.

HRESULT GetSiteStatus(
  ULONG FAR * lpulStatus
);

Parameters

  • lpulStatus
    [out] A pointer to a bitmask of flags that provides information about message status. The following flags can be set:

    • VCSTATUS_COPY
      The message can be copied.

    • VCSTATUS_DELETE
      The message can be deleted.

    • VCSTATUS_DELETE_IS_MOVE
      When deleted, a message is moved to a Deleted Items folder in its message store instead of being immediately removed from its message store.

    • VCSTATUS_MOVE
      The message can be moved.

    • VCSTATUS_NEW_MESSAGE
      A new message can be created.

    • VCSTATUS_SAVE
      The message can be saved.

    • VCSTATUS_SUBMIT
      The message can be submitted.

Return Value

  • S_OK
    The call succeeded and has returned the expected value or values.

Remarks

Form objects call the IMAPIMessageSite::GetSiteStatus method to obtain the message site object's capabilities for the current message. The flags returned in the lpulStatus parameter provide information about the message site. Typically, a form enables or disables menu commands, depending on information the flags provide about the capabilities of the message site implementation. If a new message is loaded into a form by the IPersistMessage::SaveCompleted method or the IPersistMessage::Load method, the status flags must be checked. Some message site objects, especially read-only objects, do not allow messages to be saved or deleted.

Notes to Implementers

The IMAPIMessageSite::GetSiteStatus method may require the client application to do some calculation to determine what operations can or cannot be performed on the current message. Typically, that involves looking at the status row for the current message's message store provider, or querying the store provider to determine which actions the client application can perform by using the message store. For example, to determine whether to return the MAPI_DELETE_IS_MOVE flag, check the message store object's PR_IPM_WASTEBASKET_ENTRYID (PidTagIpmWastebasketEntryId) property to see whether there is a Deleted Items folder in the message store.

For a list of interfaces related to form servers, see MAPI Form Interfaces.

MFCMAPI Reference

For MFCMAPI sample code, see the following table.

File

Function

Comment

MyMAPIFormViewer.cpp

CMyMAPIFormViewer::GetSiteStatus

MFCMAPI uses the IMAPIMessageSite::GetSiteStatus method to get the status of the specified site. It can return VCSTATUS_NEW_MESSAGE, VCSTATUS_SAVE, or VCSTATUS_SUBMIT.

See Also

Reference

IPersistMessage::Load

IPersistMessage::SaveCompleted

PidTagIpmWastebasketEntryId Canonical Property

IMAPIMessageSite : IUnknown

Concepts

MFCMAPI as a Code Sample

MAPI Form Interfaces