fatalError Method

Implementation Syntax

Sub fatalError(oLocator As IVBSAXLocator, strError As String,_ 
nErrorCode As Long)

Parameters

oLocator

The Locator object, which contains line and column numbers of the error. SystemID and PublicID may be unavailable for particular data sources, such as character buffer.

strError

The error information.

nErrorCode

The error code.

Remarks

This notification of a nonrecoverable error corresponds to the definition of a fatal error in section 1.2 of the Worldwide Web Consortium (W3C) XML 1.0 Recommendation. For example, a parser would use this method to report the violation of a well-formedness constraint. The application must assume that the document is unusable after the parser has invoked this method. Parsing should continue only to collect additional error messages. In addition, the parser is free to stop reporting any other events once this method has been invoked.

Syntax

HRESULT fatalError(
   [in] ISAXLocator * pLocator, 
   [in] const wchar_t * pwchErrorMessage,
   [in] HRESULT hrErrorCode);

Parameters

pLocator [in]

The Locator object, which contains line and column numbers of the error. SystemID and PublicID may be unavailable for particular data sources, such as character buffer.

pwchErrorMessage [in]

The error information.

hrErrorCode [in]

The error code identifying the reason for the error.

Return Values

S_OK

The value returned when the error is handled, but parsing stops for fatal errors.

Other

The value returned if parsing should be aborted.