RPC_BINDING_HANDLE

Jenis data RPC_BINDING_HANDLE mendeklarasikan handel pengikatan yang berisi informasi yang digunakan pustaka run-time RPC untuk mengakses informasi pengikatan.

typedef I_RPC_HANDLE RPC_BINDING_HANDLE;

Keterangan

Pustaka run-time menggunakan informasi pengikatan untuk membuat hubungan server klien yang memungkinkan eksekusi panggilan prosedur jarak jauh. Berdasarkan konteks di mana handel pengikatan dibuat, ini dianggap sebagai handel pengikatan server atau handel pengikatan klien.

Handel pengikatan server berisi informasi yang diperlukan klien untuk membangun hubungan dengan server tertentu. Sejumlah rutinitas run-time RPC API mengembalikan handel pengikatan server yang dapat digunakan untuk melakukan panggilan prosedur jarak jauh.

Handel pengikatan klien tidak dapat digunakan untuk melakukan panggilan prosedur jarak jauh. Pustaka run-time RPC membuat dan menyediakan handel pengikatan klien ke prosedur server yang disebut (juga disebut rutinitas manajer server) sebagai parameter RPC_BINDING_HANDLE. Handel pengikatan klien berisi informasi tentang klien panggilan.

Fungsi RpcBinding* dan RpcNsBinding* mengembalikan kode status RPC_S_WRONG_KIND_OF_BINDING ketika aplikasi menyediakan jenis handel pengikatan yang salah.

Aplikasi dapat berbagi satu handel pengikatan di beberapa utas eksekusi. Pustaka run-time RPC mengelola panggilan prosedur jarak jauh bersamaan yang menggunakan satu handel pengikatan. Namun, aplikasi bertanggung jawab untuk mengikat kontrol konkurensi untuk operasi yang memodifikasi handel pengikatan. Operasi ini mencakup rutinitas berikut:

• RpcBindingFree
• RpcBindingReset
• RpcBindingSetAuthInfo
• RpcBindingSetObject

Misalnya, jika aplikasi berbagi handel pengikatan di dua utas eksekusi dan mengatur ulang titik akhir handle pengikatan di salah satu utas dengan memanggil RpcBindingReset, hasilnya tidak terdefinisi. Handel pengikatan pada utas lain mungkin juga diatur ulang, atau operasi mungkin gagal, atau prosesnya mungkin macet. Kesalahan umum adalah membebaskan handel pengikatan saat panggilan sedang berlangsung; ini biasanya merusak proses panggilan.

Jika Anda tidak ingin konkurensi, Anda dapat merancang aplikasi untuk membuat salinan handel pengikatan dengan memanggil RpcBindingCopy. Dalam hal ini, operasi ke handel pengikatan pertama tidak berpengaruh pada handel pengikatan kedua.

Rutinitas yang memerlukan handel pengikatan sebagai parameter menunjukkan jenis data RPC_BINDING_HANDLE. Parameter penanganan pengikatan diteruskan oleh nilai.

Persyaratan