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/valueDescription
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/valueDescription
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

 

 

Show: