DrtGetSearchResult function (drt.h)

  • Article

The DrtGetSearchResult function allows the caller to retrieve the search result(s).

Syntax

HRESULT DrtGetSearchResult(
  [in]  HDRT_SEARCH_CONTEXT hSearchContext,
  [out] ULONG               ulSearchResultSize,
        DRT_SEARCH_RESULT   *pSearchResult
);

Parameters

[in] hSearchContext

Handle to the search context to close. This parameter is returned by the DrtStartSearch function.

[out] ulSearchResultSize

Pointer to the DRT_SEARCH_RESULT structure containing the search result.

pSearchResult

Receives a pointer to a DRT_SEARCH_RESULT structure containing the search results.

Return value

This function returns S_OK on success. Other possible values include:

Return code Description
E_INVALIDARG
 ulSearchPathSize is less than the size of DRT_SEARCH_RESULT.
E_HANDLE
 hSearchContext is an invalid handle.
DRT_E_FAULTED
 the DRT cloud is in the faulted state.
DRT_E_INSUFFICIENT_BUFFER
 The provided buffer is insufficient in size to contain the search result.
DRT_E_NO_MORE
 There are no more results to return.
DRT_E_TIMEOUT
 The search failed because it timed out.
DRT_E_SEARCH_IN_PROGRESS
 The search is currently in progress.

Requirements

Requirement Value
Minimum supported client Windows 7 Professional [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header drt.h
Library Drt.lib
DLL Drt.dll

See also

DrtStartSearch