Fungsi RpcBindingToStringBindingA (rpcdce.h)

Artikel
03/15/2023

Fungsi RpcBindingToStringBinding mengembalikan representasi string dari handel pengikatan.

Sintaks

RPC_STATUS RpcBindingToStringBindingA(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

Parameter

Binding

Handel pengikatan klien atau server untuk dikonversi ke representasi string dari handel pengikatan.

StringBinding

Mengembalikan penunjuk ke penunjuk ke representasi string dari handel pengikatan yang ditentukan dalam parameter Pengikatan .

Tentukan nilai null untuk mencegah RpcBindingToStringBinding mengembalikan parameter StringBinding . Dalam hal ini, aplikasi tidak memanggil fungsi RpcStringFree .

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_BINDING	Handel pengikatan tidak valid.

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

Keterangan

Fungsi RpcBindingToStringBinding mengonversi handel pengikatan klien atau server ke representasi stringnya.

Pustaka run-time RPC mengalokasikan memori untuk string yang dikembalikan dalam parameter StringBinding . Aplikasi ini bertanggung jawab untuk memanggil fungsi RpcStringFree untuk membatalkan alokasi memori tersebut.

Jika handel pengikatan dalam parameter Pengikatan berisi UUID objek nihil, bidang UUID objek tidak disertakan dalam string yang dikembalikan.

Untuk mengurai parameter StringBinding yang dikembalikan, panggil fungsi RpcStringBindingParse .

Catatan Untuk mengkueri alamat klien, aplikasi dimulai dengan memanggil fungsi RpcBindingServerFromClient untuk mendapatkan handel pengikatan server yang terikat sebagian. Handel pengikatan server dapat digunakan untuk mendapatkan pengikatan string dengan memanggil RpcBindingToStringBinding. Server kemudian dapat memanggil RpcStringBindingParse untuk mengekstrak alamat jaringan klien dari pengikatan string.

Catatan

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

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree

Bagikan melalui