Fungsi RpcBindingCreateA (rpcdce.h)
Fungsi RpcBindingCreate membuat handel pengikatan RPC cepat baru berdasarkan templat yang disediakan.
Sintaks
RPC_STATUS RpcBindingCreateA(
[in] RPC_BINDING_HANDLE_TEMPLATE_V1_A *Template,
[in, optional] RPC_BINDING_HANDLE_SECURITY_V1_A *Security,
[in, optional] RPC_BINDING_HANDLE_OPTIONS_V1 *Options,
[out] RPC_BINDING_HANDLE *Binding
);
Parameter
[in] Template
RPC_BINDING_HANDLE_TEMPLATE struktur yang menjelaskan handel pengikatan yang akan dibuat oleh panggilan ini. Data ini mungkin ditimpa selama panggilan, sehingga API tidak mempertahankan referensi ke data ini. Pemanggil harus membebaskan memori yang digunakan oleh struktur ini saat API kembali.
[in, optional] Security
RPC_BINDING_HANDLE_SECURITY struktur yang menjelaskan opsi keamanan untuk handel pengikatan ini. Data ini mungkin ditimpa selama panggilan, sehingga API tidak mempertahankan referensi ke data ini. Pemanggil harus membebaskan memori yang digunakan oleh struktur ini saat API kembali.
Parameter ini bersifat opsional. Jika parameter ini diatur ke NULL, pengaturan keamanan default untuk RPC_BINDING_HANDLE_SECURITY akan digunakan.
[in, optional] Options
RPC_BINDING_HANDLE_OPTIONS struktur yang menjelaskan opsi tambahan untuk handel pengikatan. Data ini mungkin ditimpa selama panggilan, sehingga API tidak mempertahankan referensi ke data ini. Pemanggil harus membebaskan memori yang digunakan oleh struktur ini saat API kembali.
Parameter ini bersifat opsional. Jika parameter ini diatur ke NULL, opsi default untuk RPC_BINDING_HANDLE_OPTIONS akan digunakan.
[out] Binding
RPC_BINDING_HANDLE struktur yang berisi handel pengikatan yang baru dibuat. Jika fungsi ini tidak mengembalikan RPC_S_OK, maka konten struktur ini tidak terdefinisi. Untuk panggilan RPC non-lokal, handel ini harus diteruskan ke RpcBindingBind.
Nilai kembali
Fungsi ini mengembalikan RPC_S_OK pada keberhasilan; jika tidak, kode kesalahan RPC_S_* dikembalikan. Untuk informasi tentang kode kesalahan ini, lihat Nilai Pengembalian RPC.
Menampilkan kode | Deskripsi |
---|---|
|
Handel pengikatan berhasil dibuat. |
|
Fitur USANG RPC diminta untuk handel pengikatan ini.
Catatan Satu-satunya urutan protokol yang didukung untuk API ini adalah ncalrpc; memilih urutan protokol lain menghasilkan pengembalian kode status kesalahan ini.
|
Keterangan
Handel pengikatan RPC yang dikembalikan oleh API ini dapat digunakan dengan fungsi lain yang menerima handel pengikatan sebagai parameter.
Namun, sebelum panggilan apa pun dapat dilakukan pada handel pengikatan, RpcBindingBind harus dipanggil untuk membuat handel pengikatan tersedia untuk panggilan jarak jauh. RPCBindingCreate API tidak menyentuh jaringan atau mencoba berkomunikasi dengan server RPC -- melainkan, hanya membangun struktur data internal berdasarkan nilai yang disediakan dalam templat. Pengembalian yang berhasil tidak menunjukkan bahwa server RPC tersedia, dapat diakses, atau ditentukan dengan benar.
Catatan
Header rpcdce.h mendefinisikan RpcBindingCreate sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | rpcdce.h (termasuk Rpc.h) |
Pustaka | Rpcrt4.lib |
DLL | Rpcrt4.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk