Registry values under the MyMail subkey that are specific to, and set by, the transport, but that are also used by Inbox, are described in the following table. These registry values are usually set by the Service Definition dialog box that gets called when a mail service is being added, for example, MyMail. Once the MyMail service is connected, these and other values under the MyMail registry subkey may be modified or added by the service's TransportProps routine.
Note The "Type" entry in the table defines the registry value type.
| Registry value | Type | Description |
|---|---|---|
| CopyMaxLines | REG_DWORD | Indicates the maximum number of messsage body lines to copy from the server.
This value is relevant only if the CopyAllLines value is set to zero. |
| CopyAllLines | REG_DWORD | Indicates that the entire message body should be copied from the server, if the value is non-zero.
If this value is zero, CopyMaxLines lines of the message body are copied. |
| GrabRead | REG_DWORD | Indicates whether a remote message should be saved locally when it is read from the server.
If the TypeOfGrab value is one, and the messages are not remote, GrabRead will be ignored. If this value is not zero, the remote message is saved locally. If this value is zero, the remote message is not stored locally when read. If your service allows this option, messages with attachments and non-Interpersonal Messages (non-IPMs) will not work properly in this scenario. |
| TypeOfGrab | REG_DWORD | Indicates whether the entire message or only the message header should be copied from the server.
If this value is zero, only the message headers are copied. If this value is one, all messages, headers, and bodies are copied. However, the amount of the body to be copied is limited to CopyMaxLines. |
| SvcAutoDisco | REG_DWORD | Indicates whether Inbox should force an automatic disconnect after the service sends or receives messages.
If this value is zero, the user must manually disconnect the service. If this value is one, Inbox automatcally disconnects the service after connecting and performing the implied send-and-receive operations. |
| NewMailNotify | REG_DWORD | Indicates what type of notification Inbox should perform when a new message arrives.
If this value is zero, Inbox beeps. If this value is one, Inbox beeps and also displays a message box. |
| RefreshTime | REG_DWORD | Indicates the number of minutes between refreshes. This is relevant only if the DoRefresh value is one. |
| DoRefresh | REG_DWORD | Indicates whether messages should periodically be refreshed; the refresh interval is defined by the RefreshTime registry value.
If this value is zero, Inbox does not do a periodic refresh. If this value is one, Inbox refreshes every RefreshTime minutes. |
| SvcAddrBook | REG_SZ | Indicates which address book (data base contacts) field to use for queries. This is a Unicode string
For example, you could set SvcAddrBook to the value "Internet," or the value "2-Way Paging." Each of these strings is a long name, called a property name of a database property. You can obtain this property name by specifying a property with a call to GetPropertyDataStruct function. GetPropertyDataStruct also returns a database position index of the specified property. The property name returned can then be used with GetMatchingEntry. The transport service can set SvcAddrBook to the long name of any property identifier that it will search. |
| SvcRemember | REG_DWORD | Indicates whether the password should be remembered.
If this value is zero, Inbox displays a dialog box and prompts the user for a password each time the service connects. If this value is one, the system remembers the password, and Inbox does not display the dialog box. |
| SvcRtn | REG_SZ | A Unicode string that defines the default return address to use. On a "Reply," Inbox will place this string in the "From:" field of the message header.
The service driver could check or modify this entry to provide an appropriate or desired return address. |
| SvcPass | REG_SZ | A Unicode string that stores the password provided at the time of logon. |
| SvcKey | REG_SZ | An encrypted Unicode string that identifies the registry key that corresponds to the currently connected service; this key is under the ServiceLibs subkey.
This indicates to Inbox the DLL that is to be loaded when the SvcName service is connected by the user within the Inbox application. See Registering a Transport Service earlier in this chapter. |