Fungsi RpcBindingCreateA (rpcdce.h)

Artikel
03/15/2023

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
RPC_S_OK	Handel pengikatan berhasil dibuat.
RPC_S_CANNOT_SUPPORT	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.

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

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

RPC_BINDING_HANDLE

RpcBindingBind

Bagikan melalui