Important:
This is retired content. 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 content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

A developer can customize what happens in response to a user selecting an e-mail hyperlink in the calendar application. The developer must provide an event handler to implement the desired behavior. The event handler is this OnEmailmethod of the ICalContactLinkHandlerinterface.

When a user selects an e-mail hyperlink with the Actionkey or by tapping the link, the VK_ACTIONevent is generated. When the calendar application receives this event, and there is a registered OnEmailevent handler, the application invokes the handler. The application places information about the calendar item and the hyperlink into the parameters that it passes to the handler.

The handler need not handle all hyperlinks. If it is invoked for a hyperlink which it does not handle, it should return a status of E_FAIL. When the application sees this status it will provide default behavior.

For an overview of Actionkey customization, see Customizing Action Key Behavior for Calendar Hyperlinks.

Caution:
This method is not currently supported.

Syntax 

STDMETHOD (OnEmail)(
	LONG 
lApptId,
   LPCWSTR 
pwszEmail,
   DWORD 
cchEmail
)

Parameters

lApptId

[in] The OID of the calendar item that contains the hyperlinked e-mail address.

pwszEmail

[in] The e-mail address.

cchEmail

[in] The number of characters in the e-mail address.

Return Value

This method returns the following values.

S_OK

Indicates success.

E_FAIL

Indicates failure. The calendar application will provide default behavior.

Requirements

Header cemapihandler.h
Windows Mobile Windows Mobile 6.5 and later

See Also