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
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_BINDING	Handel pengikatan tidak valid.
RPC_S_WRONG_KIND_OF_BINDING	Ini adalah jenis pengikatan yang salah untuk operasi.

 

Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.

 

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

Lihat juga

RpcEpRegister

RpcEpRegisterNoReplace