Fungsi RpcBindingFromStringBinding (rpcdce.h)
Fungsi RpcBindingFromStringBinding mengembalikan handel pengikatan dari representasi string dari handel pengikatan.
Sintaks
RPC_STATUS RpcBindingFromStringBinding(
RPC_CSTR StringBinding,
RPC_BINDING_HANDLE *Binding
);
Parameter
StringBinding
Penunjuk ke representasi string dari handel pengikatan.
Binding
Mengembalikan penunjuk ke handel pengikatan server.
Nilai kembali
Nilai | Makna |
---|---|
|
Panggilan berhasil. |
|
Pengikatan string tidak valid. |
|
Urutan protokol tidak didukung pada host ini. |
|
Urutan protokol tidak valid. |
|
Format titik akhir tidak valid. |
|
String terlalu panjang. |
|
Alamat jaringan tidak valid. |
|
Argumen tidak valid. |
|
Pengidentifikasi keluarga alamat jaringan tidak valid. |
Keterangan
Fungsi RpcBindingFromStringBinding membuat handel pengikatan server dari representasi string dari handel pengikatan. Parameter StringBinding tidak harus berisi UUID objek. Dalam hal ini, pengikatan yang dikembalikan berisi UUID nihil. Jika parameter StringBinding yang disediakan tidak berisi bidang titik akhir, parameter Pengikatan yang dikembalikan adalah handel pengikatan yang terikat sebagian. Jika parameter StringBinding yang disediakan berisi bidang titik akhir, titik akhir dianggap sebagai titik akhir yang terkenal. Jika parameter StringBinding yang disediakan tidak berisi bidang alamat host, parameter Pengikatan yang dikembalikan mereferensikan host lokal.
Aplikasi membuat pengikatan string dengan memanggil fungsi RpcStringBindingCompose atau dengan menyediakan konstanta string karakter. Pembuatan pengikatan string dengan metode ini tidak melibatkan kontak dengan server. Keberhasilan atau kegagalan API tidak akan menunjukkan ketersediaan server.
Ketika aplikasi selesai menggunakan parameter Pengikatan , aplikasi harus memanggil fungsi RpcBindingFree untuk merilis memori yang digunakan oleh handel pengikatan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | rpcdce.h (termasuk Rpc.h) |
Pustaka | Rpcrt4.lib |
DLL | Rpcrt4.dll |