IMAPIControl::Activate
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.
Performs a task such as displaying a dialog box or starting a programmatic operation when a client application user clicks the button control.
HRESULT Activate(
ULONG ulFlags,
ULONG_PTR ulUIParam
);
Parameters
ulFlags
[in] Reserved; must be zero.ulUIParam
[in] A handle to the parent window of the dialog box on which the button control appears.
Return Value
- S_OK
The button control was successfully activated.
Remarks
The IMAPIControl::Activate method performs tasks following a user's click of the button control. After the click occurs, as part of the processing of the display table, MAPI makes a call to Activate after first calling IMAPIControl::GetState to determine whether the button is enabled.
For more information about how to implement Activate and the other IMAPIControl : IUnknown methods, see Control Object Implementation.