Platform SDK: Exchange Server

IExchangeRuleExt::Install

The Install method informs the custom action DLL of the context in which it is invoked. The Microsoft Exchange Client calls this method either when the user selects a custom action for an Inbox Assistant rule or when that rule is triggered.

HRESULT Install(
  LPEXCHANGERULEEXTCALLBACK percb,  
  ULONG ulContext                   
);
 

Parameters

percb
Input parameter. Points to an instance of an IExchangeRuleExtCallback interface.
ulContext
Input parameter. The context in which the custom action DLL is invoked:
ERCONTEXT_INFO
The user selected a custom action in the Inbox Assistant.
ERCONTEXT_EXEC
The Microsoft Exchange Client triggered that custom action.

Return Values

Return E_FAIL if the user cancels the command; return NOERROR if the command completes successfully.

Remarks

The custom action DLL is invoked from either the Inbox Assistant or from the Microsoft Exchange Client. The Inbox Assistant invokes this method so it can then assign a custom action to a rule using the GetCommand method. The Microsoft Exchange Client invokes this method so it can then apply that rule to the associated message using the Command method.

See Also

IExchangeRuleExt, QueryRelease