RpcBindingFromStringBindingA (rpcdce.h)

Artikel
03/01/2024

Fungsi RpcBindingFromStringBinding mengembalikan handel pengikatan dari representasi string dari handel pengikatan.

Sintaks

RPC_STATUS RpcBindingFromStringBindingA(
  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
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_STRING_BINDING	Pengikatan string tidak valid.
RPC_S_PROTSEQ_NOT_SUPPORTED	Urutan protokol tidak didukung pada host ini.
RPC_S_INVALID_RPC_PROTSEQ	Urutan protokol tidak valid.
RPC_S_INVALID_ENDPOINT_FORMAT	Format titik akhir tidak valid.
RPC_S_STRING_TOO_LONG	String terlalu panjang.
RPC_S_INVALID_NET_ADDR	Alamat jaringan tidak valid.
RPC_S_INVALID_ARG	Argumen tidak valid.
RPC_S_INVALID_NAF_ID	Pengidentifikasi keluarga alamat jaringan tidak valid.

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

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.

Catatan

Header rpcdce.h mendefinisikan RpcBindingFromStringBinding 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 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

Lihat juga

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose

Bagikan melalui