Bagikan melalui


Fungsi RpcServerInqBindingHandle (rpcdce.h)

Fungsi RpcServerInqBindingHandle mendapatkan handel pengikatan untuk panggilan RPC yang dilayankan oleh utas tempat RpcServerInqBindingHandle dipanggil.

Sintaks

RPC_STATUS RpcServerInqBindingHandle(
  RPC_BINDING_HANDLE *Binding
);

Parameter

Binding

RPC_BINDING_HANDLE struktur yang, setelah berhasil, menerima handel pengikatan untuk panggilan yang dilayankan oleh utas tempat RpcServerInqBindingHandle juga dipanggil.

Jika panggilan gagal, parameter ini tidak terdefinisi.

Menampilkan nilai

Fungsi ini mengembalikan RPC_S_OK pada keberhasilan; jika tidak, kode kesalahan RPC_S_* dikembalikan. Fungsi ini tidak dapat gagal kecuali dipanggil pada utas yang saat ini tidak melayani panggilan RPC.

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

Keterangan

RpcServerInqBindingHandle digunakan untuk mendapatkan handel pengikatan untuk panggilan RPC yang saat ini dijalankan pada utas tempat API ini juga dipanggil. Karena banyak API RPC memerlukan handel pengikatan sebagai input, ini adalah cara yang mudah untuk mendapatkan handel pengikatan.

Perhatikan bahwa semua API RPC sisi server yang mengambil handel pengikatan sebagai parameter memungkinkan Anda untuk meneruskan NULL sebagai nilai yang diterima. Meneruskan NULL alih-alih handel pengikatan menunjukkan bahwa handel pengikatan untuk panggilan RPC yang saat ini dijalankan dalam utas yang sama harus digunakan. Namun, jika Anda memanggil API sisi server dari utas terpisah, maka Anda harus menyediakan handel pengikatan non-NULL kepada mereka.

Jika Anda menggunakan handel pengikatan eksplisit dan tidak menggunakan handel konteks khusus utas, handel pengikatan untuk panggilan adalah parameter pertama untuk rutinitas manajer server Anda. Namun, jika Anda tidak menggunakan handel eksplisit atau jika Anda menggunakan handel konteks, RpcServerInqBindingHandle adalah satu-satunya cara untuk mendapatkan handel pengikatan untuk digunakan di utas lain.

API ini dapat digunakan untuk panggilan asinkron dan sinkron, meskipun kurang berguna untuk panggilan asinkron karena handel pengikatan dapat diperoleh karena status asinkron selalu merupakan parameter pertama untuk semua panggilan RPC asinkron dan handel pengikatan dapat diperoleh langsung darinya menggunakan RpcAsyncGetCallHandle.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header rpcdce.h (termasuk Rpc.h)
Pustaka Rpcrt4.lib
DLL Rpcrt4.dll

Lihat juga

RpcAsyncGetCallHandle