Simple Sample

  • Article

Note

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.

 

The Simple sample (QSample) is an example command-line application written in C++ that executes a query using the OLE DB Helper API functions CICreateCommand and CITextToFullTree to simplify the coding needed to create a query to an Indexing Service catalog.

Source: mssdk\samples\winbase\indexing\Simple\

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 execute queries 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 query text and, optionally, values for the machine, catalog, scope, columns, query language dialect, locale, sort order, and other arguments (see the following list).

  3. Submit the query by entering, at the command-line prompt, qsample <query> [arguments]

    where the value of the command-line parameter <query> is an Indexing Service query, and the arguments can include the following.

    Value Meaning
    /c:<catalog> is the name of the catalog. Default is SYSTEM.
    /d displays the DBCOMMANDTREE structure for the command tree. Default is don't display.
    /e:<locale> is the ISO locale identifier; for example, EN-US. Default is system locale.
    /f:(+|-) + or - specifies forcing use of the index. Default is "+" to force use of the index.
    /g specifies forcing a master merge.
    /i:<inputfile> specifies an input file to read with queries, one per line.
    /j specifies to return just files in the scope path, and not subdirectories.
    /l:<dialect> specifies the query language dialect, 1 or 2. Default is 1.
    /m:<machine> is the name of the computer. Default is the local computer.
    /o:<columns> is the output column list. Default is path.
    /p:<scope> is the scope path of the query, absolute or relative.
    /q specifies to execute quietly. Display only query results.
    /r:# is the number of times to repeat the command.
    /s:<sort> is the sort column list. Default is none. For example: write[d]. Append [a] for ascending (default) or [d] for descending.
    /t specifies to display catalog statistics.
    /u specifies to check if the catalog is up to date.
    /x:<maxhits> is the maximum number of hits to retrieve. Default is no limit.

     

Programming Notes

This sample is simpler than the AdvQuery sample because it uses the OLE DB Helper functions CICreateCommand and CITextToFullTree instead of creating a command tree and using the low-level ICommandTree interface.

Parameters

You can specify the following columns with the /o argument.

  • attrib
  • create
  • directory
  • docauthor
  • dockeywords
  • doclastauthor
  • docsubject
  • doctitle
  • fileindex
  • filename
  • hitcount
  • path
  • rank
  • size
  • vpath
  • workid
  • write

You can specify the following locales with the /e argument.

  • af

  • ar ar-ae ar-bh ar-dz ar-eg ar-iq ar-jo ar-kw ar-lb

    ar-ly ar-ma ar-om ar-qa ar-sa ar-sy ar-tn ar-ye

  • be bg ca cs da

  • de de-at de-ch de-li de-lu

  • en en-au en-bz en-ca en-gb en-ie en-jm en-nz en-tt

    en-us en-za

  • es es-ar es-bo es-c es-co es-cr es-do es-ec es-gt

    es-hn es-mx es-ni es-pa es-pe es-pr es-py es-sv

    es-uy es-ve

  • et eu fa fi fo

  • fr fr-be fr-ca fr-ch fr-lu

  • gd gd-ie

  • he hi hr hu in is

  • it it-ch

  • ja ji ko ko lt lv mk ms mt n neutr

  • nl-be

  • no p

  • pt pt-br

  • rm

  • ro ro-mo

  • ru ru-mo

  • s sb sk sq sr

  • sv sv-fi

  • sx sz th tn tr ts uk ur ve vi xh

  • zh-cn zh-hk zh-sg zh-tw

  • zu

Examples

Finds all files in the "system" catalog on the local computer that contain the word "mango" and outputs the size and path values.

qsample mango /o:size,path

Finds all files in the "system" catalog on the local computer with the relative path "." that contain the word "peach" but not the word "apple" and outputs the path value sorted in order of increasing rank.

qsample "peach and not apple" /s:rank[d] /p:.

Finds all files in the "system" catalog on the computer "dogfood" whose size is greater than 1000000 bytes and outputs the size and path values sorted in order of increasing size.

qsample "@size > 1000000" /o:size,path /s:size[a] /m:dogfood

Finds all files in the "system" catalog on the local computer whose docauthor property is "joe" and outputs the docauthor and path values sorted in order of ascending docauthor and then ascending path.

qsample "@docauthor joe" /o:docauthor,path /s:docauthor,path

Finds all files in the "system" catalog on the local computer with an absolute scope of c:\files and outputs the path in unsorted order.

qsample apricot /p:c:\\files

Finds all files in the "sources" catalog on the computer "index1" containing the word "pear" and outputs the path value in unsorted order.

qsample /m:index1 /c:sources pear