Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method suspends parsing and returns control to the application with an E_PENDING HRESULT.

Syntax 

HRESULT suspend( );

Parameters

None.

Return Value

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

State Return code

Ready

E_FAIL. If suspendis called when the reader is not parsing, the reader remains in the ready state.

Parsing

S_OK. Suspends the reader.

Suspended

E_FAIL. If suspendis called while the reader is suspended, the reader remains suspended.

Remarks

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

Requirements

Header msxml2.h, msxml2.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also