ITransportCallback::OnError method

[ITransportCallback::OnError is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Handles high-level errors such as TCP/IP and connection failures.

Syntax

HRESULT OnError(
  [in] IXPSTATUS          ixpstatus,
  [in] LPIXPRESULT        pResult,
  [in] IInternetTransport *pTransport
);

Parameters

ixpstatus [in]

Type: IXPSTATUS

Specifies an IXPSTATUS value that indicates the current status of the transport.

pResult [in]

Type: LPIXPRESULT

Specifies a pointer to an IXPRESULT structure that contains the error information.

pTransport [in]

Type: IInternetTransport*

Specifies a pointer to the IInternetTransport object that called OnError.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

A transport calls this method when it encounters a fatal error like disconnection from the server. Normal protocol errors are returned through each transport's OnResponse method.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Product	Outlook Express 6.0
Header	Imnxport.h
IDL	Imnxport.idl
DLL	Msoe.dll (version 6.0 or later)