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