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.
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
See Also
errorHandler Property (Visual Basic)
putErrorHandler Method (C-C++)
ISAXLocator Interface