Share via

fatalError Method

  • Article

 

Receives notification of a nonrecoverable error.

Visual Basic 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.

C/C++ 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.

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.

Versioning

Implemented in: MSXML 3.0 and later

Applies to

ISAXErrorHandler Interface

See Also

errorHandler Property (Visual Basic)
putErrorHandler Method (C-C++)
ISAXLocator Interface