readyState Property (IXMLHTTPRequest)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Represents the state of the request.

Script Syntax

            lValue = oXMLHttpRequest.readyState;

Remarks

Script Parameters

None.

Script Return Value

Variant. State of the request, as an I4 (4-byte integer). The following table shows the defined values.

C/C++ Syntax

HRESULT get_readyState(
  long* plState
);

Remarks

C/C++ Parameters

• plState
  [out, retval] State of the request, as an I4 (4-byte integer). The following table shows the defined values.

  (0) UNINITIALIZED	The object has been created, but not initialized (the open Method (IXMLHTTPRequest) has not been called).
  (1) LOADING	The object has been created, but the send Method (IXMLHTTPRequest) has not been called.
  (2) LOADED	send Method (IXMLHTTPRequest) has been called and the status and headers are available, but the response is not yet available.
  (3) INTERACTIVE	Some data has been received. You can call responseBody Property (IXMLHTTPRequest) and responseText Property (IXMLHTTPRequest) to get the current partial results.
  (4) COMPLETED	All the data has been received, and the complete data is available in responseBody Property (IXMLHTTPRequest) and responseText Property (IXMLHTTPRequest).

C/C++ Return Values

• S_OK
  Value returned if successful.

• E_INVALIDARG
  Value returned if the input argument is NULL.

Requirements

General Remarks

It represents the state of the request as an I4 (4-byte integer).

This property returns a 4-byte integer.

The property is read-only, and applies to the following interface:

IXMLHTTPRequest

See Also

Concepts

open Method (IXMLHTTPRequest)
send Method (IXMLHTTPRequest)
responseBody Property (IXMLHTTPRequest)
responseText Property (IXMLHTTPRequest)
status Property (IXMLHTTPRequest)
statusText Property (IXMLHTTPRequest)