---
title: "ReadyState Property (RDS) | Microsoft Docs"
ms.technology: connectivity
ms.custom: ""
ms.date: "01/19/2017"
ms.reviewer: 
ms.prod: sql  
ms.prod_service: connectivity
ms.topic: conceptual
apitype: "COM"
helpviewer_keywords: 
  - "ReadyState property [ADO]"
ms.assetid: 5be75bc7-1171-4440-a37e-c8cc6b5cd865
author: MightyPen
ms.author: genemi
---
# ReadyState Property (RDS)
Indicates the progress of a [DataControl](../../../ado/reference/rds-api/datacontrol-object-rds.md) object as it retrieves data into its [Recordset](../../../ado/reference/ado-api/recordset-object-ado.md) object.  
  
> [!IMPORTANT]
>  Beginning with Windows 8 and Windows Server 2012, RDS server components are no longer included in the Windows operating system (see Windows 8 and [Windows Server 2012 Compatibility Cookbook](https://www.microsoft.com/download/details.aspx?id=27416) for more detail). RDS client components will be removed in a future version of Windows. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Applications that use RDS should migrate to [WCF Data Service](https://go.microsoft.com/fwlink/?LinkId=199565).  
  
## Settings and Return Values  
 Sets or returns one of the following values.  
  
|Value|Description|  
|-----------|-----------------|  
|**adcReadyStateLoaded**|The current query is still executing and no rows have been fetched. The **DataControl** object's **Recordset** is not available for use.|  
|**adcReadyStateInteractive**|An initial set of rows retrieved by the current query has been stored in the **DataControl** object's **Recordset** and are available for use. The remaining rows are still being fetched.|  
|**adcReadyStateComplete**|All rows retrieved by the current query have been stored in the **DataControl** object's **Recordset** and are available for use.<br /><br /> This state will also exist if an operation aborted due to an error, or if the **Recordset** object is not initialized.|  
  
> [!NOTE]
>  Each client-side executable file that uses these constants must provide declarations for them. You can cut and paste the constant declarations you want from the file Adcvbs.inc, located in the default installation folder for the RDS library.  
  
## Remarks  
 Use the [onReadyStateChange](../../../ado/reference/rds-api/onreadystatechange-event-rds.md) event to monitor changes in the **ReadyState** property during an asynchronous query operation. This is more efficient than periodically checking the value of the property.  
  
 If an error occurs during an asynchronous operation, the **ReadyState** property changes to **adcReadyStateComplete**, the [State](../../../ado/reference/ado-api/state-property-ado.md) property changes from **adStateExecuting** to **adStateClosed**, and the **Recordset** object [Value](../../../ado/reference/ado-api/value-property-ado.md) property remains *Nothing*.  
  
## Applies To  
 [DataControl Object (RDS)](../../../ado/reference/rds-api/datacontrol-object-rds.md)  
  
## See Also  
 [ReadyState Property Example (VBScript)](../../../ado/reference/rds-api/readystate-property-example-vbscript.md)   
 [Cancel Method (RDS)](../../../ado/reference/rds-api/cancel-method-rds.md)   
 [ExecuteOptions Property (RDS)](../../../ado/reference/rds-api/executeoptions-property-rds.md)