Konstanta Opsi Pengikatan

  • Artikel

Aplikasi mengatur konstanta opsi pengikatan untuk mengontrol bagaimana pustaka run-time RPC memproses panggilan prosedur jarak jauh. Tabel berikut ini mencantumkan setiap properti pengikatan, dan nilai konstanta yang relevan untuk properti pengikatan.

Catatan

Semua opsi antrean pesan (MQ) dalam tabel berikut ini hanya berlaku untuk Windows 2000. Windows XP dan versi yang lebih baru tidak mendukung antrean pesan. Pengembang tidak disarankan untuk menggunakan antrean pesan.

Konstanta/nilai Deskripsi
RPC_C_OPT_BINDING_NONCAUSAL
9
 Default. Jika FALSE, pesanan panggilan kausal. Panggilan RPC dijalankan dalam urutan pengiriman yang ketat. Lihat Keterangan.
Jika TRUE, pemesanan panggilan non-skalaal. Panggilan RPC dijalankan secara independen. Lihat Keterangan.
RPC_C_OPT_MAX_OPTIONS
17
 Tidak diperlukan untuk program aplikasi. Digunakan secara internal oleh Microsoft.
RPC_C_DONT_FAIL
4
 Tidak diperlukan untuk program aplikasi. Digunakan secara internal oleh Microsoft.
RPC_C_OPT_SESSION_ID
6
 Jika TRUE, ID sesi dihasilkan untuk setiap koneksi.
RPC_C_OPT_COOKIE_AUTH
7
 Jika TRUE, autentikasi berbasis cookie sisi klien digunakan untuk koneksi. Penunjuk ke struktur RPC_C_OPT_COOKIE_AUTH_DESCRIPTOR diteruskan sebagai parameter OptionValue di RpcBindingSetOption.
RPC_C_OPT_RESOURCE_TYPE_UUID
8
 Tidak diperlukan untuk program aplikasi. Digunakan secara internal oleh Microsoft.
RPC_C_OPT_DONT_LINGER
13
 Jika TRUE, matikan paksa asosiasi setelah handel/handel konteks pengikatan terakhir di atasnya dibebaskan.
RPC_C_OPT_UNIQUE_BINDING
11
 Ketika diatur ke true, RPC tidak menggunakan kembali koneksi yang ada. Handel pengikatan unik dibuka untuk setiap koneksi dan status dipertahankan untuk setiap handel pengikatan unik.

Keterangan

Secara default, pustaka run-time RPC menjalankan panggilan pada handel pengikatan tertentu dari setiap utas aplikasi dalam urutan pengiriman yang ketat. Ini tidak menjamin bahwa panggilan dari utas yang berbeda pada handel pengikatan yang sama diserialisasikan. Aplikasi multithreaded harus menserialisasikan panggilan RPC mereka. Jika perilaku ini terlalu ketat, Anda dapat mengaktifkan pengurutan non-skalaal. Ketika Anda melakukannya, pustaka run-time RPC menjalankan panggilan secara independen. Ini tidak memberlakukan perintah pada pengiriman mereka.

Salah satu contoh aplikasi yang mungkin menemukan pemesanan non-skalaal berguna adalah program multithreaded yang utasnya melakukan panggilan pada handel pengikatan yang sama. Demikian pula, program yang menggunakan beberapa panggilan asinkron pada handel pengikatan akan menemukan urutan non-skalaal opsi yang nyaman. Contoh lain mungkin adalah program proksi Internet yang menggunakan satu utas untuk menangani permintaan untuk beberapa klien. Dalam setiap kasus ini, akan sangat ketat untuk mencoba membuat serial panggilan prosedur jarak jauh.

Opsi RPC_C_OPT_DONT_LINGER hanya dapat diatur pada handel pengikatan yang menggunakan urutan protokol ncalrpc atau ncacn_* . Ini tidak dapat digunakan pada urutan protokol ncadg_* . Fungsi RpcBindingSetOption dengan opsi ini harus dipanggil pada handel pengikatan di mana setidaknya satu panggilan RPC telah dilakukan. Jika tidak ada panggilan RPC yang dilakukan pada handel pengikatan, RPC_S_WRONG_KIND_OF_BINDING dikembalikan dari panggilan fungsi RpcBindingSetOption . Opsi ini berlaku untuk seluruh asosiasi, terlepas dari berapa banyak handel pengikatan yang melekat pada asosiasi. Karena diperiksa sebelum asosiasi dihancurkan, itu dapat diatur kapan saja sebelum handel pengikatan ditutup.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung
 Windows 2000 Server [hanya aplikasi desktop]
Header
Rpcdce.h;
Rpcdcep.h

Lihat juga

RpcBindingSetOption

RpcBindingInqOption

Mengelola Set Koneksi Jaringan (Asosiasi)