Fungsi RpcBindingSetOption (rpcdce.h)

Artikel
03/15/2023

Fungsi RpcBindingSetOption memungkinkan aplikasi klien menentukan opsi antrean pesan pada handel pengikatan.

Sintaks

RPC_STATUS RpcBindingSetOption(
  RPC_BINDING_HANDLE hBinding,
  unsigned long      option,
  ULONG_PTR          optionValue
);

Parameter

hBinding

Pengikatan server untuk dimodifikasi.

option

Properti pengikatan untuk dimodifikasi. Untuk daftar opsi pengikatan dan kemungkinan nilainya, lihat Opsi Pengikatan Konstanta. Lihat Keterangan untuk informasi tentang fitur batas waktu Panggilan RPC.

optionValue

Nilai baru untuk properti pengikatan. Lihat Keterangan.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_CANNOT_SUPPORT	Fungsi ini tidak didukung untuk sistem operasi atau transportasi. Perhatikan bahwa memanggil RpcBindingSetOption pada handel pengikatan yang menggunakan urutan protokol apa pun selain ncacn_* akan gagal dan mengembalikan nilai ini.

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

Keterangan

Proses klien RPC menggunakan RpcBindingSetOption untuk mengontrol kualitas layanan pengiriman, pengelogan panggilan, dan masa pakai panggilan. Mengubah properti penanganan pengikatan akan memengaruhi semua panggilan jarak jauh hingga properti diubah oleh panggilan lain ke RpcBindingSetOption. Anda juga dapat memanggil RpcBindingSetAuthInfo untuk mengatur opsi keamanan untuk handel pengikatan.

Windows XP: Fitur Batas Waktu Panggilan RPC:

Memanggil fungsi RpcBindingSetOption dengan Opsi diatur ke RPC_C_OPT_CALL_TIMEOUT dan OptionValue yang diatur ke nilai waktu habis (dalam milidetik) memungkinkan pengembang untuk mengatur batas waktu server RPC yang mencegah utas menjadi tawanan ke server RPC yang tidak responsif. Fitur ini menyelamatkan pengembang dari pembatalan panggilan secara eksplisit ke server RPC yang tidak responsif. Pemantauan timer untuk waktu habis diatur ulang oleh klien RPC setelah menerima setiap paket. Jika waktu habis kedaluwarsa tanpa menerima paket dari server, klien RPC mengembalikan RPC_S_CALL_CANCELLED. Perhatikan bahwa server RPC mungkin masih pada akhirnya menjalankan panggilan, meskipun klien akan membuang respons.

Atur OptionValue ke INFINITE atau nol untuk batas waktu tak terbatas. Jangan ubah opsi ini dari utas lain saat panggilan sedang berlangsung. Jangan mencoba mencoba lagi panggilan yang dibatalkan; melakukannya meningkatkan beban pada server yang sudah tidak responsif. Fitur batas waktu panggilan RPC hanya berguna untuk panggilan RPC yang berorientasi koneksi dan sinkron, seperti yang dibuat pada urutan protokol ncacn_* . Untuk panggilan RPC datagram, asinkron, atau lokal, opsi ini diabaikan oleh run-time RPC.

Fitur batas waktu panggilan RPC berguna dalam banyak situasi, seperti pembaruan antarmuka pengguna yang sebaliknya akan menunggu server RPC yang sibuk merespons (membuat pengguna menonton jam kacamata), atau ketika banyak server RPC dapat melayani permintaan, sehingga memungkinkan klien untuk lebih cepat mengidentifikasi dan melewati server yang tidak responsif.

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

Antrean Pesan RPC

RpcBindingInqAuthClient

RpcBindingInqOption

RpcBindingSetAuthInfo

message

Bagikan melalui