Fungsi RpcBindingCopy (rpcdce.h)

Artikel
03/04/2024

Fungsi RpcBindingCopy menyalin informasi pengikatan dan membuat handel pengikatan baru.

Sintaks

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

Parameter

SourceBinding

Handel pengikatan server yang informasi pengikatan referensinya disalin.

DestinationBinding

Mengembalikan penunjuk ke handel pengikatan server yang mengacu pada informasi pengikatan yang disalin.

Nilai kembali

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 RpcBindingCopy menyalin informasi pengikatan server yang dirujuk oleh parameter SourceBinding . RpcBindingCopy menggunakan parameter DestinationBinding untuk mengembalikan handel pengikatan server baru untuk informasi pengikatan yang disalin. RpcBindingCopy juga menyalin informasi autentikasi dari parameter SourceBinding ke parameter DestinationBinding .

Aplikasi menggunakan RpcBindingCopy ketika ingin mencegah perubahan yang dilakukan pada informasi pengikatan oleh satu utas memengaruhi informasi pengikatan yang digunakan oleh utas lain.

Setelah aplikasi memanggil RpcBindingCopy, operasi yang dilakukan pada handel pengikatan SourceBinding tidak memengaruhi informasi pengikatan yang direferensikan oleh handel pengikatan DestinationBinding . Demikian pula, operasi yang dilakukan pada handel pengikatan DestinationBinding tidak memengaruhi informasi pengikatan yang direferensikan oleh handel pengikatan SourceBinding .

Jika aplikasi menginginkan perubahan satu utas ke informasi pengikatan untuk memengaruhi informasi pengikatan yang digunakan oleh utas lain, aplikasi harus berbagi satu handel pengikatan di seluruh utas. Dalam hal ini, aplikasi bertanggung jawab untuk kontrol konkurensi penanganan pengikatan.

Ketika aplikasi selesai menggunakan handel pengikatan yang ditentukan oleh parameter DestinationBinding , aplikasi harus memanggil fungsi RpcBindingFree untuk melepaskan memori yang digunakan oleh handel pengikatan DestinationBinding dan informasi pengikatan yang direferensikan.

Catatan Microsoft RPC hanya mendukung RpcBindingCopy di aplikasi klien, bukan di aplikasi server.

Persyaratan

Persyaratan	Nilai
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

RpcBindingFree

Bagikan melalui