IMAPISupport::DoConfigPropsheet

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Displays a configuration property sheet.

HRESULT DoConfigPropsheet(
  ULONG_PTR ulUIParam,
  ULONG ulFlags,
  LPSTR lpszTitle,
  LPMAPITABLE lpDisplayTable,
  LPMAPIPROP lpConfigData,
  ULONG ulTopPage
);

Parameters

  • ulUIParam
    [in] A handle to the parent window of the property sheet.

  • ulFlags
    [in] Reserved; must be zero.

  • lpszTitle
    [in] A pointer to the title of the property sheet.

  • lpDisplayTable
    [in] A pointer to the display table that describes the controls to appear on the property sheet.

  • lpConfigData
    [in] A pointer to the IMAPIProp implementation to be used for accessing the configuration properties to be displayed on the property sheet.

  • ulTopPage
    [in] A zero-based index to the default top page of the property sheet.

Return Value

  • S_OK
    The configuration property sheet was displayed.

Remarks

The IMAPISupport::DoConfigPropsheet method is implemented for all support objects. DoConfigPropSheet provides a standard user interface for displaying the properties of service providers and message services. You should use this standard dialog box for all configuration property displays so that users benefit from a consistent Windows interface.

Service providers call DoConfigPropSheet as part of their implementation of the IMAPIStatus::SettingsDialog method or from a button used to display details on properties. Message services call DoConfigPropSheet from their message service entry point function.

Notes to Callers

You can create the display table pointed to by the lpDisplayTable parameter by calling the BuildDisplayTable function or with custom code.

See Also

Reference

BuildDisplayTable

CreateIProp

IABProvider::Logon

IMAPIProp : IUnknown

IMAPIStatus::SettingsDialog

IMsgServiceAdmin : IUnknown

IMSProvider::Logon

IXPProvider::TransportLogon

IMAPISupport : IUnknown