IMailSyncHandler::Install

4/8/2010

The Install method is called by Messaging to install the transport and then passes the configuration information to the transport.

Syntax

HRESULT Install (
  LPCWSTR pszProfileName,
  LPCWSTR pszIncomingServer,
  LPCWSTR pszOutgoingServer,
  GUID * pidNetwork
);

Parameters

  • pszProfileName
    [in] Profile name of the transport instance.
  • pszIncomingServer
    [in] Incoming server name that the transport should use to synchronize the e-mail into the device.
  • pszOutgoingServer
    [in] Outgoing server name that the transport should use to send outgoing e-mails.
  • pidNetwork
    [in] Reference to the network GUID identifier to use when connecting to the incoming and outgoing servers.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    Indicates success.

Remarks

The transport should maintain the information for later use.

Requirements

Header cemapi.h
Library cemapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMailSyncHandler

Other Resources

Messaging