//+-------------------------------------------------------------------------
//
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
// PARTICULAR PURPOSE.
//
// Copyright (c) 1997-1999 Microsoft Corporation. All Rights Reserved.
//
// Sample Name: AdvQuery - Sample Advanced Query Application
//
//--------------------------------------------------------------------------
Description
===========
The AdvQuery sample is an example command-line application written in C++
that executes a query using the OLE DB Provider interfaces such as ICommand
and ICommandTree. It shows how to specify a catalog, machine name, and
scope. It can also display the OLE DB command tree for the query.
Path
====
Source: mssdk\samples\winbase\indexing\AdvQuery\
User's Guide
============
* To build the sample
1. Set the Lib environment variable to "D:\mssdk\Lib;%Lib%" and the
Include environment variable to "D:\mssdk\Include;%Include%",
where D: is the drive on which you installed the Platform SDK.
2. Correctly set the CPU environment variable to, for example, "i386".
3. Open a command window and change the directory to the source path
of the sample.
4. Build the sample by entering, at the command-line prompt, "nmake".
* To issue a query to Indexing Service using the sample
1. Open a command window and change the directory to the path of the
built sample.
2. Formulate a query that you know will succeed. You need to know the
machine, catalog, scope, and query text.
3. Submit the query by entering, at the command-line prompt,
advquery <query> [/c:<catalog>] [/m:<machine>] [/s:<scope>] [/d]
where
<query> is a query in the Indexing Service Query Language
<catalog> is the name of the catalog (default is "system")
<machine> is the name of the machine (default is ".")
<scope> is the root path (default is entire catalog)
/d displays the DBCOMMANDTREE (default is don't display)
Programming Notes
=================
The sample prints the rank, size, and path of each file that matches the
query. The query results are sorted by rank (how well the file matches
the query).
This example is more complex than the Simple (QSample) sample because it
creates a command tree and use the low-level ICommandTree interface
instead of using the OLE DB Helper functions CICreateCommand and
CITextToFullTree.
Parameters
----------
The <query> parameter can be a word or a phrase. Files that contain the
word or phrase are listed in the result. To include a space in a query,
enclose the query in quotes.
The <catalog> parameter is the name of the catalog to be queried. The
default is "system", which is the default catalog installed with Windows
2000. Additional catalogs can be created with the Indexing Service
snap-in of the Microsoft Management Console (MMC).
The <machine> parameter is the name of the machine on which the query
will be executed. The default is ".", which is the local machine.
Machine names should not be preceeded with two backslashes.
The <scope> parameter is the file path under which files must exist
to be included in the results. The default is "\", which includes all
scopes in the catalog.
The "/d" parameter displays the DBCOMMANDTREE structure built to execute
the query.
Examples
--------
advquery foo
Finds all files in the "system" catalog on the local machine that
contain the word "foo".
advquery "foo bar" "/s:c:\my directory"
Finds all files in the "system" catalog on the local machine that
contain the phrase "foo bar" that are in the specified directory
or any subdirectory.
advquery foo /m:SERVERNAME
Finds all files in the "system" catalog on machine "servername" that
contain the word "foo".
