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 : IUnknown.

HRESULT Activate(
  ULONG ulFlags,   
  ULONG ulUIParam  
);

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 a Control Object.