DRT_SEARCH_INFO structure (drt.h)

The DRT_SEARCH_INFO structure represents a search query issued with DrtStartSearch.

Syntax

typedef struct drt_search_info_tag {
  DWORD    dwSize;
  BOOL     fIterative;
  BOOL     fAllowCurrentInstanceMatch;
  BOOL     fAnyMatchInRange;
  ULONG    cMaxEndpoints;
  DRT_DATA *pMaximumKey;
  DRT_DATA *pMinimumKey;
} DRT_SEARCH_INFO, *PDRT_SEARCH_INFO;

Members

dwSize

Specifies the byte count of DRT_SEARCH_INFO.

fIterative

Indicates whether the search is iterative. If set to TRUE, the search is iterative.

fAllowCurrentInstanceMatch

Indicates whether search results can contain matches found in the local DRT instance. If set to TRUE, the search results are capable of containing matches found in the local DRT instance.

fAnyMatchInRange

If set to true, the search will stop locating the first key falling within the specified range. Otherwise, the search for the closest match to the target key specified by DrtStartSearch will continue.

cMaxEndpoints

Specifies the number of results to return. This includes closest and exact matches. If this value is greater than 1 when fIterative is TRUE, the search will only return 1 result.

pMaximumKey

Specifies the numerically largest key value the infrastructure should attempt to match.

pMinimumKey

Specifies the numerically smallest key value the infrastructure should attempt to match.

Requirements

Requirement	Value
Minimum supported client	Windows 7 Professional [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	drt.h

See also

DrtStartSearch