DrtStartSearch 函式 (drt.h)

  • 發行項

DrtStartSearch 函式會使用 DRT_SEARCH_INFO 結構中指定的準則，搜尋DRT中的索引鍵。

語法

HRESULT DrtStartSearch(
  [in]           HDRT                  hDrt,
  [in]           DRT_DATA              *pKey,
  [in, optional] const DRT_SEARCH_INFO *pInfo,
                 ULONG                 timeout,
  [in]           HANDLE                hEvent,
  [in, optional] const PVOID           pvContext,
  [out]          HDRT_SEARCH_CONTEXT   *hSearchContext
);

參數

[in] hDrt

DrtOpen 函式所傳回的DRT句柄。

[in] pKey

包含索引鍵 之DRT_DATA 結構的指標。

[in, optional] pInfo

指定搜尋屬性 之DRT_SEARCH_INFO 結構的指標。

timeout

指定停止搜尋之前的毫秒。

[in] hEvent

處理 DrtStartSearch API完成或找到中繼節點時發出訊號的事件。

[in, optional] pvContext

透過事件傳遞至應用程式之內容數據的指標。

[out] hSearchContext

用於呼叫 DrtEndSearch的句柄。

傳回值

此函式會在成功時傳回S_OK。 其他可能的值包括：

傳回碼 Description
E_HANDLE
 hDrt 是無效的句柄，或 phKeyRegistration 是無效的句柄
E_INVALIDARG
  • hSearchContext 為 NULL。
  • pKey 為 NULL
  • pKeyDRT_DATA 結構的pb 成員為 NULL。
  • pInfo 已傳入，最小索引鍵是在 pInfo 內設定以供範圍搜尋，但最大索引鍵為 NULL。
  • pInfo 已傳入，在 pInfo 內設定最大索引鍵以進行範圍搜尋，但最小索引鍵為 NULL。
DRT_E_INVALID_KEY_SIZE
  • pKeyDRT_DATA 結構的cb 成員不等於 256 位。
  • pInfo 已傳入，但 pInfo 內最小金鑰集的金鑰大小不等於 256 位。
  • pInfo 已傳入，但 pInfo 內最大金鑰集的金鑰大小不等於 256 位。
DRT_E_INVALID_SEARCH_INFO
 pInfo 已傳入，但 pInfo 的 dwSize 不等於DRT_SEARCH_INFO結構的大小。
DRT_E_INVALID_MAX_ENDPOINTS
 pInfo 已傳入，但 cMaxEndpoints (max endpoints) 設定為 pInfo 或 pInfo 內已傳入 0，但 cMaxEndpoints 大於 1， 並將 fAnyMatchInRange 設定為 TRUE
DRT_E_INVALID_SEARCH_RANGE
 最小值和最大值索引鍵值相等，但目標不同。
DRT_E_FAULTED
 DRT 雲端處於錯誤狀態。
E_OUTOFMEMORY
 系統記憶體不足。
E_UNEXPECTED
 DRT 正在關閉。
E_FAIL
 發生非預期的嚴重錯誤。

規格需求

需求 值
最低支援的用戶端 Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 drt.h
程式庫 Drt.lib
Dll Drt.dll

另請參閱

DRT_SEARCH_INFO

DrtContinueSearch

DrtEndSearch

DrtOpen