Fungsi RpcStringBindingComposeA (rpcdce.h)

Artikel
03/13/2024

Fungsi RpcStringBindingCompose membuat handel pengikatan string.

Sintaks

RPC_STATUS RpcStringBindingComposeA(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Parameter

ObjUuid

Penunjuk ke representasi string yang dihentikan null dari UUID objek. Misalnya, string 6B29FC40-CA47-1067-B31D-00DD010662DA mewakili UUID yang valid.

ProtSeq

Penunjuk ke representasi string null-terminated dari urutan protokol. Lihat Catatan.

NetworkAddr

Penunjuk ke representasi string alamat jaringan yang dihentikan null. Format alamat jaringan dikaitkan dengan urutan protokol. Lihat Catatan.

Endpoint

Penunjuk ke representasi string titik akhir yang dihentikan null. Format titik akhir dan konten dikaitkan dengan urutan protokol. Misalnya, titik akhir yang terkait dengan urutan protokol ncacn_np adalah nama pipa dalam format \pipe\pipename. Lihat Catatan.

Options

Penunjuk ke representasi string opsi jaringan yang dihentikan null. String opsi dikaitkan dengan urutan protokol. Lihat Catatan.

StringBinding

Mengembalikan penunjuk ke penunjuk ke representasi string null-dihentikan dari handel pengikatan.

Tentukan nilai NULL untuk mencegah RpcStringBindingCompose mengembalikan parameter StringBinding . Dalam hal ini, aplikasi tidak memanggil RpcStringFree. Lihat Catatan.

Catatan Untuk informasi selengkapnya, lihat Pengikatan String.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_STRING_UUID	Representasi string UUID tidak valid.

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

Keterangan

Aplikasi memanggil rutinitas RpcStringBindingCompose untuk menggabungkan UUID objek, urutan protokol, alamat jaringan, titik akhir, dan opsi jaringan lainnya ke dalam representasi string dari handel pengikatan.

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

Tentukan nilai parameter null atau berikan string kosong (\0) untuk setiap string input yang tidak memiliki data.

Karakter garis miring terbalik harfiah dalam string bahasa C harus dikutip. String C aktual untuk nama server untuk urutan protokol ncacn_np muncul sebagai \\servername, dan string C aktual untuk nama pipa muncul sebagai \pipe\pipename.

Catatan

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

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree

Bagikan melalui