STAT_* Constants

[Indexing Service is no longer supported as of Windows XP and is unavailable for use as of Windows 8. Instead, use Windows Search for client side search and Microsoft Search Server Express for server side search.]

Reflects the execution (fill) status and the reliability status of a query.

Bits 00-02: Fill Status: How query data is being updated, if at all.

Constant/value	Description
STAT_BUSY 0	The asynchronous query is still running.
STAT_ERROR 0x1	The query is in an error state.
STAT_DONE 0x2	The query is complete.
STAT_REFRESH 0x3	The query is complete, but updates are resulting in additional query computation.

Bits 03-15: Reliability: How accurate the query result is.

Constant/value	Description
STAT_PARTIAL_SCOPE 0x8	The results of the query are incomplete because one or more servers in a multivolume query were unavailable.
STAT_NOISE_WORDS 0x10	Noise words were replaced by wildcard characters in the content query.
STAT_CONTENT_OUT_OF_DATE 0x20	The results of the query might be incorrect because the query involved modified, but unindexed, files.
STAT_REFRESH_INCOMPLETE 0x40	The results of the query might be incorrect because the query involved modified and re-indexed files whose content was not included.
STAT_CONTENT_QUERY_INCOMPLETE 0x80	The content query was too complex to complete or required enumeration instead of use of the content index.
STAT_TIME_LIMIT_EXCEEDED 0x100	The results of the query might be incorrect because the query execution time reached the maximum allowable time.
STAT_SHARING_VIOLATION 0x200	The results of the query might be incorrect because a sharing violation occurred on the query result.

Examples

This example retrieves the fill and reliability status values for the specified rowset.

XInterface<IRowsetInfo> xIRowsetInfo;
HRESULT hr = xIRowset->QueryInterface( IID_IRowsetInfo,
                                       xIRowsetInfo.GetQIPointer() );
 
if ( SUCCEEDED( hr ) )
{
    DBPROPID propId = MSIDXSPROP_ROWSETQUERYSTATUS;
    DBPROPIDSET propSet;
    propSet.rgPropertyIDs = &propId;
    propSet.cPropertyIDs = 1;
    const GUID guidRowsetExt = DBPROPSET_MSIDXS_ROWSETEXT;
    propSet.guidPropertySet = guidRowsetExt;
 
    ULONG cPropertySets = 0;
    DBPROPSET * pPropertySets;
 
    hr = xIRowsetInfo->GetProperties( 1,
                                      &propSet,
                                      &cPropertySets,
                                      &pPropertySets );
 
    if ( SUCCEEDED( hr ) )
    {
        DWORD dwStatus = pPropertySets->rgProperties->vValue.ulVal;
 
        CoTaskMemFree( pPropertySets->rgProperties );
        CoTaskMemFree( pPropertySets );
 
        DWORD dwFill = QUERY_FILL_STATUS( dwStatus );
        DWORD dwReliability = QUERY_RELIABILITY_STATUS( dwStatus );
    }
}

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
End of client support	Windows 7
End of server support	Windows Server 2008 R2
Header	Ntquery.h

See also

IRowsetInfo

DBPROPSET_MSIDXS_ROWSETEXT