Fungsi RpcBindingReset (rpcdce.h)
Fungsi RpcBindingReset mengatur ulang handel pengikatan sehingga host ditentukan tetapi server pada host tersebut tidak ditentukan.
Sintaks
RPC_STATUS RpcBindingReset(
RPC_BINDING_HANDLE Binding
);
Parameter
Binding
Handel pengikatan server untuk mengatur ulang.
Menampilkan nilai
| Nilai | Makna |
|---|---|
|
Panggilan berhasil. |
|
Handel pengikatan tidak valid. |
|
Ini adalah jenis pengikatan yang salah untuk operasi. |
Keterangan
Klien memanggil fungsi RpcBindingReset untuk memisahkan instans server tertentu dari handel pengikatan server yang ditentukan dalam parameter Pengikatan . Fungsi RpcBindingReset memisahkan instans server dengan menghapus bagian titik akhir alamat server dalam handel pengikatan. Host tetap tidak berubah dalam handel pengikatan. Hasilnya adalah handel pengikatan server yang terikat sebagian.
RpcBindingReset tidak memengaruhi informasi autentikasi parameter Pengikatan , jika ada.
Jika klien bersedia dilayani oleh instans server yang kompatibel pada host yang ditentukan dalam handel pengikatan, klien memanggil fungsi RpcBindingReset sebelum melakukan panggilan prosedur jarak jauh menggunakan handel pengikatan pengikatan . Klien tidak boleh memanggil fungsi RpcBindingReset untuk handel pengikatan tempat panggilan dijalankan.
Ketika klien melakukan panggilan prosedur jarak jauh berikutnya menggunakan pengikatan reset (terikat sebagian), pustaka run-time RPC klien menggunakan titik akhir terkenal dari spesifikasi antarmuka klien, jika ada. Jika tidak, pustaka run-time klien secara otomatis berkomunikasi dengan layanan pemetaan titik akhir pada host jarak jauh yang ditentukan untuk mendapatkan titik akhir server yang kompatibel dari database peta titik akhir. Jika server yang kompatibel berada, pustaka run-time RPC memperbarui pengikatan dengan titik akhir baru. Jika server yang kompatibel tidak ditemukan, panggilan prosedur jarak jauh gagal. Untuk panggilan menggunakan protokol koneksi (ncacn), kode status EPT_S_NOT_REGISTERED dikembalikan ke klien. Untuk panggilan menggunakan protokol datagram (ncadg), kode status RPC_S_COMM_FAILURE dikembalikan ke klien.
Aplikasi server harus mendaftarkan semua handel pengikatan dengan memanggil RpcEpRegister dan RpcEpRegisterNoReplace jika server ingin tersedia untuk klien yang melakukan panggilan prosedur jarak jauh pada handel pengikatan reset.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | rpcdce.h (termasuk Rpc.h) |
| Pustaka | Rpcrt4.lib |
| DLL | Rpcrt4.dll |