readyState Property (IXMLHTTPRequest)
A version of this page is also available for
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.
(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++ 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
| Header | msxml2.h, msxml2.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
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:
See Also
Concepts
open Method (IXMLHTTPRequest)
send Method (IXMLHTTPRequest)
responseBody Property (IXMLHTTPRequest)
responseText Property (IXMLHTTPRequest)
status Property (IXMLHTTPRequest)
statusText Property (IXMLHTTPRequest)