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.
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 |