Fungsi RpcBindingFree (rpcdce.h)

Artikel
08/25/2023

Fungsi RpcBindingFree merilis sumber daya penanganan pengikatan.

Sintaks

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Parameter

Binding

Penunjuk ke pengikatan server yang akan dibebaskan.

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

Fungsi RpcBindingFree merilis memori yang digunakan oleh handel pengikatan server. Informasi pengikatan referensi yang dibuat secara dinamis selama eksekusi program juga dirilis. Aplikasi memanggil fungsi RpcBindingFree setelah selesai menggunakan handel pengikatan. Handel pengikatan RPC tidak boleh dibebaskan sampai semua panggilan menggunakan handel selesai; kegagalan untuk melakukannya akan menyebabkan hasil yang tidak dapat diprediksi.

Handel pengikatan dibuat secara dinamis dengan memanggil fungsi berikut:

Jika operasi berhasil membebaskan pengikatan, parameter Pengikatan mengembalikan nilai NULL.

Catatan Microsoft RPC hanya mendukung RpcBindingFree di aplikasi klien, atau di aplikasi server untuk handel pengikatan yang dihasilkan dengan RpcBindingServerFromClient.

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