2.2.1.30.1 Database Properties
This section details the properties that are used by the Windows Search Protocol to control the behavior of the GSS. These properties are grouped into three property sets, identified in the guidPropertySet field of the CDbPropSet structure.
The following table lists the properties that are part of the DBPROPSET_FSCIFRMWRK_EXT property set.
|
Value |
Meaning |
|---|---|
|
DBPROP_CI_CATALOG_NAME 0x00000002 |
Specifies the name of the catalog or catalogs to query. The value MUST be a VT_LPWSTR or a VT_VECTOR | VT_LPWSTR. |
|
DBPROP_CI_INCLUDE_SCOPES 0x00000003 |
Specifies one or more paths to be included in the query. The value MUST be a VT_LPWSTR or a VT_VECTOR | VT_LPWSTR. |
|
DBPROP_CI_SCOPE_FLAGS 0x00000004 |
Specifies how the paths specified by the DBPROP_CI_INCLUDE_SCOPES property are to be treated. The value MUST be a VT_I4 or a VT_VECTOR | VT_I4. |
|
DBPROP_CI_QUERY_TYPE 0x00000007 |
Specifies the type of query using a CDbColId structure. The structure MUST be set such that the eKind field contains 0x00000001 and the GUID and ulId fields are filled with zeros. |
The following table lists the flags for the DBPROP_CI_SCOPE_FLAGS property.
|
Value |
Meaning |
|---|---|
|
QUERY_DEEP 0x01 |
If set, indicates that files in the scope directory and all subdirectories are included in the results. If clear, only files in the scope directory are included in the results. |
|
QUERY_VIRTUAL_Path 0x02 |
If set, indicates that the scope is a virtual path. If clear, indicates that the scope is a physical directory. |
The following table lists the query types for the DBPROP_CI_QUERY_TYPE property.
|
Value |
Meaning |
|---|---|
|
CiNormal 0x00000000 |
A regular query. |
The following table lists the properties that are part of the DBPROPSET_QUERYEXT property set.
|
Value |
Meaning |
|---|---|
|
DBPROP_USECONTENTINDEX 0x00000002 |
Use the inverted index to optimize the speed of evaluating content restrictions at the cost of the index possibly being out of date. The value MUST be a VT_BOOL. If TRUE, the server is allowed to fail these queries. |
|
DBPROP_DEFERNONINDEXEDTRIMMING 0x00000003 |
Some operations, such as filtering by scope or security, can be expensive. This flag indicates that it is acceptable to defer this filtering until the results are actually requested. The value MUST be a VT_BOOL. |
|
DBPROP_USEEXTENDEDDBTYPES 0x00000004 |
Indicates if the client supports VT_VECTOR data types. If TRUE, the client supports VT_VECTOR; if FALSE, the server is to convert VT_VECTOR data types to VT_ARRAY data types. The value MUST be a VT_BOOL. |
|
DBPROP_FIRSTROWS 0x00000007 |
If TRUE, the GSS returns the first rows that match. If FALSE, then rows by default are returned in order of descending rank. The value MUST be a VT_BOOL. |
|
DBPROP_ENABLEROWSETEVENTS 0x00000010 |
If TRUE, this indicates that the server generates rowset events that are relevant to the associated query.This value MUST be a VT_BOOL. |
The following table lists the properties that are part of the DBPROPSET_CIFRMWRKCORE_EXT property set.
|
Value |
Meaning |
|---|---|
|
DBPROP_MACHINE 0x00000002 |
Specifies the names of the computers on which a query is to be processed. The value MUST be either VT_BSTR or VT_ARRAY | VT_BSTR. |
|
DBPROP_CLIENT_CLSID 0x00000003 |
Specifies a connection constant for the GSS. The value MUST be a VT_CLSID containing 0x2A4880706FD911D0A80800A0C906241A. |