IMAPIControl::Activate

The IMAPIControl::Activate method performs a task   such as displaying a dialog box or starting a programmatic operation   when the button control is clicked by a user of a client application.

Quick Info

See IMAPIControl : IUnknown3ZDM3V5.

HRESULT Activate(

Parameters

ulFlags

Reserved; must be zero.

ulUIParam

[in] Handle of the parent window for the dialog box on which the button control appears.

Return Values

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 if the button is enabled.

For more information about implementing Activate and the other IMAPIControl methods, see Implementing Control Objects1MJEJ0R.

See Also

IMAPIControl::GetStateKY09JU