Fungsi RpcStringBindingParseW (rpcdce.h)

Artikel
08/25/2023

Fungsi RpcStringBindingParse mengembalikan bagian UUID objek dan bagian alamat dari pengikatan string sebagai string terpisah. Aplikasi memanggil RpcStringBindingParse untuk mengurai representasi string dari handel pengikatan ke dalam bidang komponennya. Fungsi RpcStringBindingParse mengembalikan bagian UUID objek dan bagian alamat dari pengikatan string sebagai string terpisah.

Sintaks

RPC_STATUS RpcStringBindingParseW(
  RPC_WSTR StringBinding,
  RPC_WSTR *ObjUuid,
  RPC_WSTR *Protseq,
  RPC_WSTR *NetworkAddr,
  RPC_WSTR *Endpoint,
  RPC_WSTR *NetworkOptions
);

Parameter

StringBinding

Penunjuk ke representasi string yang dihentikan null dari pengikatan.

ObjUuid

Mengembalikan penunjuk ke penunjuk ke representasi string yang dihentikan null dari UUID objek.

Tentukan nilai NULL untuk mencegah RpcStringBindingParse mengembalikan parameter ObjectUuid . Dalam hal ini, aplikasi tidak memanggil RpcStringFree.

Protseq

Mengembalikan penunjuk ke penunjuk ke representasi string null-dihentikan dari urutan protokol. Untuk daftar urutan protokol yang didukung Microsoft RPC, lihat Pengikatan String.

Tentukan nilai NULL untuk mencegah RpcStringBindingParse mengembalikan parameter ProtSeq . Dalam hal ini, aplikasi tidak memanggil RpcStringFree.

NetworkAddr

Mengembalikan penunjuk ke penunjuk ke representasi string alamat jaringan yang dihentikan null. Tentukan nilai NULL untuk mencegah RpcStringBindingParse mengembalikan parameter NetworkAddr . Dalam hal ini, aplikasi tidak memanggil RpcStringFree.

Endpoint

Mengembalikan penunjuk ke penunjuk ke representasi string titik akhir yang dihentikan null. Tentukan nilai NULL untuk mencegah RpcStringBindingParse mengembalikan parameter EndPoint . Dalam hal ini, aplikasi tidak memanggil RpcStringFree.

NetworkOptions

Mengembalikan penunjuk ke penunjuk ke representasi string opsi jaringan yang dihentikan null.

Tentukan nilai NULL untuk mencegah RpcStringBindingParse mengembalikan parameter NetworkOptions . Dalam hal ini, aplikasi tidak memanggil RpcStringFree.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_STRING_BINDING	Pengikatan string tidak valid.

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

Keterangan

Aplikasi memanggil rutinitas RpcStringBindingParse untuk mengurai representasi string dari handel pengikatan ke dalam bidang komponennya.

Pustaka run-time RPC mengalokasikan memori untuk setiap string komponen yang dikembalikan. Aplikasi ini bertanggung jawab untuk memanggil RpcStringFree sekali untuk setiap string yang dikembalikan untuk membatalkan alokasi memori untuk string tersebut.

Jika ada bidang parameter StringBinding yang kosong, RpcStringBindingParse mengembalikan string kosong (\0) dalam parameter output yang sesuai.

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 RpcStringBindingParse 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

RpcStringBindingCompose

RpcStringFree

Bagikan melalui