fatalError Method

MSXML 5.0 SDK

Microsoft XML Core Services (MSXML) 5.0 for Microsoft Office - SAX2 Reference

fatalError Method

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.

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.

[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.

To view reference information for Visual Basic or C/C++ only, click the Language Filter button Language Filter in the upper-left corner of the page.

See Also

errorHandler Property (Visual Basic) | putErrorHandler Method (C/C++) | ISAXLocator/IVBSAXLocator Interface

Applies to: ISAXErrorHandler/IVBSAXErrorHandler Interface