IMAPISupport::DoConfigPropsheet
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Displays a configuration property sheet.
HRESULT DoConfigPropsheet(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPTSTR 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.