Fungsi DrtStartSearch (drt.h)

Artikel
02/28/2024

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

Bagikan melalui