suspend Method

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

See Also

Page view tracker