struktur DRT_BOOTSTRAP_PROVIDER (drt.h)
Struktur DRT_BOOTSTRAP_PROVIDER mendefinisikan antarmuka DRT yang harus diimplementasikan oleh penyedia bootstrap.
Sintaks
typedef struct drt_bootstrap_provider_tag {
PVOID pvContext;
HRESULT( )(const PVOID pvContext) *Attach;
VOID( )(const PVOID pvContext) *Detach;
HRESULT((const PVOID pvContext,BOOL fSplitDetect,ULONG timeout,ULONG cMaxResults,DRT_BOOTSTRAP_RESOLVE_CONTEXT *ResolveContext,BOOL *fFatalError) * )InitResolve;
HRESULT()(const PVOID pvContext, const PVOID pvCallbackContext,DRT_BOOTSTRAP_RESOLVE_CALLBACK callback,DRT_BOOTSTRAP_RESOLVE_CONTEXT ResolveContext,BOOL *fFatalError) * IssueResolve;
VOID( )(const PVOID pvContext,DRT_BOOTSTRAP_RESOLVE_CONTEXT ResolveContext) *EndResolve;
HRESULT()(const PVOID pvContext, const SOCKET_ADDRESS_LIST *pAddressList) * Register;
VOID( )(const PVOID pvContext) *Unregister;
} DRT_BOOTSTRAP_PROVIDER, *PDRT_BOOTSTRAP_PROVIDER;
Anggota
pvContext
Arahkan ke data konteks yang ditentukan oleh pemecah masalah bootstrap. Saat membuat pemecah masalah bootstrap, pengembang diharuskan untuk mengisi resolver dengan informasi yang diperlukan; sering kali, ini terjadi sebagai penunjuk "ini". Konteks ini akan diteruskan ke semua parameter konteks dalam fungsi yang ditentukan oleh DRT_BOOTSTRAP_PROVIDER.
Attach
Menaikkan jumlah referensi untuk Penyedia Bootstrap dengan sekumpulan DRT.
pvContext
Berisi nilai pvContext dari DRT_BOOTSTRAP_PROVIDER.
Detach
Mengurangi jumlah referensi untuk Penyedia Bootstrap dengan sekumpulan DRT.
pvContext
Berisi nilai pvContext dari DRT_BOOTSTRAP_PROVIDER.
InitResolve
Dipanggil oleh infrastruktur DRT untuk menyediakan informasi konfigurasi tentang resolusi nama yang akan datang.
pvContext
Berisi nilai pvContext dari DRT_BOOTSTRAP_PROVIDER.
fSplitDetect
Menentukan apakah operasi penyelesaian sedang digunakan untuk deteksi dan pemulihan pemisahan jaringan.
waktu habis
Menentukan waktu maksimum yang harus diselesaikan sebelum waktu habis. Nilai ini diwakili dalam milidetik.
cMaxResults
Menentukan jumlah maksimum hasil yang akan dikembalikan selama operasi penyelesaian.
ResolveContext
Penunjuk ke penyelesai data tertentu.
fFatalError
Jika penyedia bootstrap mengalami kesalahan yang tidak dapat dipulihkan, parameter ini harus diatur ke TRUE ketika fungsi selesai agar DRT beralih ke status rusak. HRESULT yang tersedia untuk aplikasi lapisan yang lebih tinggi untuk penelusuran kesalahan akan muncul di anggota SDM struktur DRT_EVENT_DATA yang terkait dengan peristiwa yang menandakan transisi ke status rusak. Fungsi penyedia bootstrap ini tidak boleh mengembalikan S_OK jika mengatur bendera fFatalError ke TRUE.
IssueResolve
Dipanggil oleh infrastruktur DRT untuk mengeluarkan resolusi untuk menentukan titik akhir simpul yang sudah aktif di cloud DRT.
pvContext
Berisi nilai pvContext dari DRT_BOOTSTRAP_PROVIDER.
pvCallbackContext
Arahkan ke data konteks yang diteruskan kembali ke panggilan balik yang ditentukan oleh parameter berikutnya.
panggilan balik
BOOTSTRAP_RESOLVE_CALLBACK yang dipanggil kembali untuk setiap hasil dan DRT_E_NO_MORE.
ResolveContext
Penunjuk ke penyelesai data tertentu.
fFatalError
Jika penyedia bootstrap mengalami kesalahan yang tidak dapat dipulihkan, parameter ini harus diatur ke TRUE ketika fungsi selesai agar DRT beralih ke status rusak. HRESULT yang tersedia untuk aplikasi lapisan yang lebih tinggi untuk penelusuran kesalahan akan muncul di anggota SDM struktur DRT_EVENT_DATA yang terkait dengan peristiwa yang menandakan transisi ke status rusak. Fungsi penyedia bootstrap ini tidak boleh mengembalikan S_OK jika mengatur bendera fFatalError ke TRUE.
EndResolve
Mengakhiri resolusi titik akhir.
pvContext
Berisi nilai pvContext dari DRT_BOOTSTRAP_PROVIDER.
ResolveContext
BOOTSTRAP_RESOLVE_CONTEXT diterima dari fungsi Resolve dari penyedia bootstrap yang ditentukan.
Register
Mendaftarkan titik akhir dengan mekanisme bootstrapping. Proses ini memungkinkan simpul lain menemukan titik akhir melalui resolver bootstrap.
pvContext
Berisi nilai pvContext dari DRT_BOOTSTRAP_PROVIDER.
pAddressList
Arahkan ke daftar alamat untuk mendaftar dengan mekanisme bootstrapping.
Unregister
Fungsi ini membatalkan pendaftaran titik akhir dengan mekanisme bootstrapping. Akibatnya, simpul lain tidak akan dapat menemukan simpul lokal melalui pemecah masalah bootstrap.
pvContext
Berisi nilai pvContext dari DRT_BOOTSTRAP_PROVIDER.
Persyaratan
| Klien minimum yang didukung | Windows 7 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
| Header | drt.h |