HrProcessConvActionForSentItem

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

Quick Info

Exported by:	Outlook.exe
Called by:	Client
Implemented by:	Outlook

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

Parameters

• 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_KEY—pmbinMsgEid is actually the PidTagSearchKey of the message. Using a PidTagSearchKey is resource intensive, and should be avoided if a PidTagEntryId is available.

Return Values

HRESULT	Description
S_OK	The call was successful.
E_INVALIDARG	dwFlags contains an unknown flag.

Remarks

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.