Fungsi RpcBindingServerFromClient (rpcdce.h)

Artikel
08/25/2023

Aplikasi memanggil RpcBindingServerFromClient untuk mengonversi handel pengikatan klien menjadi handel pengikatan server yang terikat sebagian.

Sintaks

RPC_STATUS RpcBindingServerFromClient(
  RPC_BINDING_HANDLE ClientBinding,
  RPC_BINDING_HANDLE *ServerBinding
);

Parameter

ClientBinding

Handel pengikatan klien untuk dikonversi ke handel pengikatan server. Jika nilai nol ditentukan, server meniru klien yang sedang dilayani oleh utas server ini.

Catatan Parameter ini tidak boleh NULL di Windows NT 4.0.

ServerBinding

Mengembalikan handel pengikatan server.

Menampilkan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_INVALID_BINDING	Handel pengikatan tidak valid.
RPC_S_WRONG_KIND_OF_BINDING	Ini adalah jenis pengikatan yang salah untuk operasi.
RPC_S_CANNOT_SUPPORT	Tidak dapat menentukan host klien. Lihat Keterangan untuk daftar urutan protokol yang didukung.

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

Keterangan

Urutan protokol berikut mendukung RpcBindingServerFromClient:

ncadg_ip_udp
ncadg_ipx
ncacn_ip_tcp
ncacn_spx.
ncacn_np (efektif dengan Windows 2000)
ncacn_http
ncalrpc

Aplikasi mendapatkan handel pengikatan klien dari run-time RPC. Ketika panggilan prosedur jarak jauh tiba di server, run-time membuat handel pengikatan klien yang berisi informasi tentang klien panggilan. Run-time meneruskan handel ini ke fungsi manajer server sebagai argumen pertama.

Memanggil RpcBindingServerFromClient mengonversi handel klien ini ke handel server yang memiliki properti ini:

Handel server adalah handel yang terikat sebagian. Ini berisi alamat jaringan untuk klien panggilan, tetapi tidak memiliki titik akhir.
Handel server berisi UUID objek yang sama yang digunakan oleh klien panggilan. Ini bisa menjadi UUID nihil. Untuk informasi selengkapnya tentang bagaimana klien menentukan UUID objek untuk panggilan, lihat RpcBindingsetObject, RpcNsBindingImportBegin, RpcNsBindingLookupBegin, dan RpcBindingFromStringBinding.
Handel server tidak berisi informasi autentikasi.

Aplikasi server harus memanggil RpcBindingFree untuk membebaskan sumber daya yang digunakan oleh handel pengikatan server setelah tidak lagi diperlukan.

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.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll