HrProcessConvActionForSentItem

Performs post-send categorization on a mail item based on its PidTagConversationId.

Exported by:

Outlook.exe

Called by:

Client

Implemented by:

Outlook

HRESULT WINAPI HrProcessConvActionForSentItem( 
    SBinary const *pmbinStoreEid, 
    SBinary const *pmbinMsgEid, 
    SBinary const *pmbinConvID, 
    DWORD dwFlags)

pmbinStoreEid

[in] The PidTagEntryId of the store, or the PidTagStoreEntryId of the mail item. Cannot be NULL or invalid.

pmbinMsgEid

[in] The PidTagEntryId of the mail item. Cannot be NULL or invalid.

pmbinConvID

[in] The PidTagConversationId of the mail item. Cannot be NULL or invalid.

dwFlags

[in] A bitmask that specifies additional information about the method call.

  • 0—No additional options are used in this method call. This is the recommended value.

  • PCAFSIF_MSGEID_IS_SEARCH_KEYpmbinMsgEid is actually the PidTagSearchKey of the message. Using a PidTagSearchKey is resource intensive, and should be avoided if a PidTagEntryId is available.

HRESULT

Description

S_OK

The call was successful.

E_INVALIDARG

dwFlags contains an unknown flag.

Categories are considered personal information and should not be transmitted outside the mailbox of the user. Therefore, do not call HrProcessConvActionForSentItem on an unsent mail item. Instead, send the item, and then call HrProcessConvActionForSentItem on the archived copy. The archived copy may be stored in the Sent Items folder, or an equivalent location.

Your application must be in-process with Outlook.exe, such as from a COM add-in, to call HrProcessConvActionForSentItem. If you attempt to call HrProcessConvActionForSentItem out-of-process, HrProcessConvActionForSentItem will throw an access-violation exception.

Show:
© 2014 Microsoft