STAT_* Constants

  • Article

[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