Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IMAPISession::MessageOptions

Office 2007

Displays a dialog box that contains option properties for a particular address type and message.

HRESULT MessageOptions(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPTSTR lpszAdrType,
  LPMESSAGE lpMessage
);

Parameters

ulUIParam

[in] A handle to the parent window of the dialog box.

ulFlags

[in] Reserved; must be NULL.

lpszAdrType

[in] A pointer to the address type that specifies which option properties should be displayed; otherwise, NULL, indicating that all message option properties for all transport providers should be displayed.

lpMessage

[in] A pointer to the message that specifies which option properties should be displayed.

S_OK

The dialog box was successfully displayed.

MAPI_E_NOT_FOUND

No options were registered for the message and address type.

The IMAPISession::MessageOptions method displays a dialog box that specifies properties for a particular message and address type. These properties are under the control of the transport provider that handles the address type. Users can change the properties, but these changes do not take effect until the client calls the message's IMAPIProp::SaveChanges method.

Users can change option properties that apply to the following:

  • A particular message and address type.

  • All messages for a particular address type.

Changes that were made to the option properties for a particular message and address type do not affect the option properties that apply to all messages.

For more information about how to work with message option properties, see Message and Recipient Options.

For MFCMAPI sample code, see the following table.

FileFunctionComment

FolderDlg.cpp

CFolderDlg::OnGetMessageOptions

MFCMAPI uses the IMAPISession::MessageOptions method to display the message options dialog box for the specified address type for each of the selected messages.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.