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

IMAPISession::QueryDefaultMessageOpt

Office 2007

Retrieves the message option properties for a particular address type.

HRESULT QueryDefaultMessageOpt(
  LPSTR lpszAdrType,
  ULONG ulFlags,
  ULONG FAR * lpcValues,
  LPSPropValue FAR * lppOptions
);

Parameters

lpszAdrType

[in] A pointer to an address type. This string must be an ANSI string.

ulFlags

[in] Reserved; must be NULL.

lpcValues

[out] A pointer to a count of property values pointed to by the lppOptions parameter.

lppOptions

[out] A pointer to a pointer to an array of SPropValue structures that describe message option properties.

S_OK

The message option properties were successfully returned.

The IMAPISession::QueryDefaultMessageOpt method retrieves the one or more message option properties that a transport provider supports for the address type that the lpszAdrType parameter points to. Message option properties control a message's behavior after it is submitted to the transport provider; they are part of the message envelope, not its content.

The property value array that the lppOptions points to includes the property tags and values for each of the message option properties.

For MFCMAPI sample code, see the following table.

FileFunctionComment

MainDlg.cpp

CMainDlg::OnQueryDefaultMessageOpt

MFCMAPI uses the IMAPISession::QueryDefaultMessageOpt method to obtain message option properties and display them in a dialog box.

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

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.