Fungsi RpcBindingUnbind (rpcasync.h)
Fungsi RpcBindingUnbind membatalkan pengikatan handel pengikatan yang sebelumnya diikat oleh RpcBindingBind.
Sintaks
RPC_STATUS RpcBindingUnbind(
[in] RPC_BINDING_HANDLE Binding
);
Parameter
[in] Binding
RPC_BINDING_HANDLE struktur yang berisi handel pengikatan untuk membatalkan ikatan dari server RPC.
Menampilkan nilai
Fungsi ini mengembalikan RPC_S_OK pada keberhasilan; jika tidak, kode kesalahan RPC_S_* dikembalikan.
Keterangan
RpcBindingUnbind mengikat handel pengikatan yang sebelumnya terikat dari server RPC. Handel yang tidak terikat dapat dimodifikasi dengan panggilan seperti RpcBindingSetOption dan RpcBindingSetAuthInfoEx. Handel pengikatan dalam status tidak terikat dapat diikat lagi dan digunakan kembali untuk melakukan panggilan.
Hasil operasi unbind tidak terdefinisi jika dipanggil pada handel pengikatan yang saat ini memiliki panggilan RPC yang sedang berlangsung pada saat pembatalan pengikatan. Pemanggil bertanggung jawab untuk memastikan bahwa tidak ada panggilan yang sedang berlangsung pada saat operasi yang tidak terikat dicoba.
Perhatikan bahwa memanggil RpcBindingUnbind tidak selalu memutuskan sambungan klien dari server. Ini akan membatalkan informasi yang di-cache yang digunakan oleh handel pengikatan, tetapi sebenarnya pemutusan sambungan tidak dipastikan. Untuk memastikan pemutusan, bebaskan handel pengikatan dengan RpcBindingFree.
Windows Vista: Saat ini, fungsi ini hanya mendukung urutan protokol ncalrpc .
Persyaratan
| Klien minimum yang didukung | Windows Vista, Windows XP dengan SP2 [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2008, Windows Server 2003 dengan SP1 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | rpcasync.h (termasuk Rpc.h) |
| Pustaka | Rpcrt4.lib |
| DLL | Rpcrt4.dll |