Bagikan melalui


Fungsi DrtStartSearch (drt.h)

Fungsi DrtStartSearch mencari DRT untuk kunci menggunakan kriteria yang ditentukan dalam struktur DRT_SEARCH_INFO .

Sintaks

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
);

Parameter

[in] hDrt

Handel DRT yang dikembalikan oleh fungsi DrtOpen .

[in] pKey

Arahkan ke struktur DRT_DATA yang berisi kunci.

[in, optional] pInfo

Arahkan ke struktur DRT_SEARCH_INFO yang menentukan properti pencarian.

timeout

Menentukan milidetik hingga pencarian dihentikan.

[in] hEvent

Tangani ke peristiwa yang disinyalkan ketika API DrtStartSearch selesai atau simpul perantara ditemukan.

[in, optional] pvContext

Arahkan ke data konteks yang diteruskan ke aplikasi melalui peristiwa.

[out] hSearchContext

Menangani yang digunakan dalam panggilan ke DrtEndSearch.

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk:

Menampilkan kode Deskripsi
E_HANDLE
hDrt adalah handel yang tidak valid atau phKeyRegistration adalah handel yang tidak valid
E_INVALIDARG
  • hSearchContext adalah NULL.
  • pKey adalah NULL
  • Anggota pb dari struktur DRT_DATApKey adalah NULL.
  • pInfo diteruskan, kunci minimum diatur di dalam pInfo untuk pencarian rentang, tetapi kunci maksimum adalah NULL.
  • pInfo diteruskan, kunci maksimum diatur di dalam pInfo untuk pencarian rentang, tetapi kunci minimum adalah NULL.
DRT_E_INVALID_KEY_SIZE
  • Anggota cb dari struktur DRT_DATApKey tidak sama dengan 256 bit.
  • pInfo diteruskan, tetapi ukuran kunci kunci minimum yang ditetapkan di dalam pInfo tidak sama dengan 256 bit.
  • pInfo diteruskan, tetapi ukuran kunci dari kunci maksimum yang ditetapkan di dalam pInfo tidak sama dengan 256 bit.
DRT_E_INVALID_SEARCH_INFO
pInfo diteruskan tetapi dwSizepInfo tidak sama dengan ukuran struktur DRT_SEARCH_INFO .
DRT_E_INVALID_MAX_ENDPOINTS
pInfo diteruskan tetapi titik akhir maks (cMaxEndpoints) diatur ke 0 di dalam pInfo atau pInfo diteruskan tetapi cMaxEndpoints lebih besar dari 1 dengan fAnyMatchInRange diatur ke TRUE
DRT_E_INVALID_SEARCH_RANGE
Nilai kunci min dan maks sama, tetapi target berbeda.
DRT_E_FAULTED
Cloud DRT dalam keadaan rusak.
E_OUTOFMEMORY
Sistem kehabisan memori.
E_UNEXPECTED
DRT dimatikan.
E_FAIL
Terjadi kesalahan fatal tak terduga.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 Professional [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header drt.h
Pustaka Drt.lib
DLL Drt.dll

Lihat juga

DRT_SEARCH_INFO

DrtContinueSearch

DrtEndSearch

DrtBuka