TransportErrorEx

This function returns a transport-defined error code for the last mail error that occurred, as well as a Boolean value that indicates if the error is critical. It is an extension of TransportError.

At a Glance

Syntax

int TransportErrorEx(HANDLE, hService, BOOL *pfCritical);

Parameters

hService

[in] Handle to a private SERVICE structure.

pfCritical

[in] Pointer to a Boolean. If set to TRUE, the error is critical. If set to FALSE, the error is not critical.

Return Values

The return values for this function depend on the implementation of this function by the transport.

Remarks

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

An error is critical if further attempts to perform the operation that caused the error are likely to fail as well. For example, “Connection to the server lost,” “Incorrect server name provided,” and “Could not authenticate the user” are all critical errors. Noncritical errors include “Message not found,” “Message flags could not be set,” and “Folder has been deleted.”

If a transport service provider does not implement this function, the Inbox application assumes all errors are critical.