TransportProps

This function is used to add or modify information for the user’s mail service properties. TransportProps is not required to be implemented and can simply return TRUE. Note that a user interface is required to display the information.

At a Glance

Header file: Smtp.h
Windows CE versions: 1.0 and later

Syntax

BOOL TransportProps(HWND hwndParent, LPWSTR szCommonKey, LPWSTR szTransportKey,);

Parameters

hwndParent

[in] Handle to the parent window.

szCommonKey

[in] Null-terminated string that contains the top-level registry key. For Inbox, this is the HKEY_LOCAL_MACHINE\PMail\ServiceInfo key.

szTransportKey

[in] Null-terminated string that contains the transport registry key. This is the key that is associated with the user’s unique mail service.

For the sample transport service, this is the HkEY_LOCAL_MACHINE\PMail\ServiceInfo\MyMail key.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

The transport service provider must implement the TransportProps function in a DLL registered as a mail service. The Inbox application can then load this DLL and call this function.

For example, under the ServiceInfo key (that is the key defined identified by the parameter szCommonKey), a key named SAMPLE could exist. This registry key contains values that represent information such as the user’s settings and preferences. As part of this routine, such preferences as saving the user’s password can be set in the registry.