suspend Method1

 

Suspends parsing and returns control to the application.

Visual Basic Usage Syntax

oSAXXMLReader.suspend  

C/C++ Syntax

HRESULT suspend( );  

Return Values

The following table shows the return codes for the suspend method based on the state of the reader.

State Return Code
Ready E_NOTIMPL
Parsing E_NOTIMPL
Suspended E_NOTIMPL

Remarks

The following table shows behavior for the suspend method based on the state of the reader.

State Behavior
Ready Raises a trappable error. If suspend is called when the reader is in the ready state, the reader remains in the ready state.

(To be implemented in a future release.)
Parsing After suspend executes, the reader is suspended.

(To be implemented in a future release.)
Suspended Raises a trappable error. If suspend is called when the reader is in the suspended state, the reader remains in the suspended state.

(To be implemented in a future release.)

You can only suspend the reader during parsing. The suspend method must be called from within a handler call. Parsing can be restarted later with the resume method.

Versioning

MSXML 3.0, unimplemented

Applies to

IMXReaderControl Interface

See Also

abort Method1
resume Method1