Fungsi RpcEpResolveBinding (rpcdce.h)

Artikel
03/15/2023

Fungsi RpcEpResolveBinding menyelesaikan handel pengikatan server yang terikat sebagian ke dalam handel pengikatan server yang sepenuhnya terikat.

Sintaks

RPC_STATUS RpcEpResolveBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_HANDLE      IfSpec
);

Parameter

Binding

Handel pengikatan server yang terikat sebagian untuk diselesaikan ke handel pengikatan server yang sepenuhnya terikat.

IfSpec

Struktur yang dihasilkan stub yang menentukan antarmuka yang diminati.

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.

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

Keterangan

Aplikasi memanggil fungsi RpcEpResolveBinding untuk menyelesaikan handel pengikatan server yang terikat sebagian ke dalam handel pengikatan yang sepenuhnya terikat.

Menyelesaikan handel pengikatan memerlukan antarmuka UUID dan UUID objek (yang mungkin nihil). Pustaka run-time RPC meminta layanan pemetaan titik akhir pada host yang ditentukan oleh parameter Pengikatan untuk mencari titik akhir untuk instans server yang kompatibel. Untuk menemukan titik akhir, layanan pemetaan titik akhir terlihat di database peta titik akhir untuk antarmuka UUID dalam parameter IfSpec dan UUID objek dalam parameter Pengikatan , jika ada.

Bagaimana fungsi operasi pengikatan penyelesaian bergantung pada apakah handel pengikatan yang ditentukan sebagian- atau sepenuhnya terikat. Ketika klien menentukan handel yang terikat sebagian, operasi pengikatan penyelesaian memiliki kemungkinan hasil berikut:

Jika tidak ada instans server yang kompatibel yang terdaftar di database peta titik akhir, operasi pengikatan penyelesaian mengembalikan kode status EPT_S_NOT_REGISTERED.
Jika instans server yang kompatibel terdaftar di database peta titik akhir, operasi pengikatan penyelesaian mengembalikan pengikatan yang sepenuhnya terikat dan kode status RPC_S_OK.

Ketika klien menentukan handel pengikatan yang sepenuhnya terikat, operasi pengikatan penyelesaian mengembalikan handel pengikatan yang ditentukan dan kode status RPC_S_OK. Operasi pengikatan penyelesaian tidak menghubungi layanan pemetaan titik akhir.

Dalam kasus pengikatan parsial- maupun yang sepenuhnya terikat, operasi pengikatan penyelesaian tidak menghubungi instans server yang kompatibel.

Catatan Memanggil RpcEpResolveBinding tidak benar-benar diperlukan. Jika panggilan RPC dilakukan pada handel pengikatan server yang terikat sebagian, run time RPC membutuhkan langkah-langkah yang diperlukan untuk membuat pengikatan ke handel pengikatan yang sepenuhnya terikat. Run time RPC memanggil RpcEpResolveBinding, tetapi melakukannya lebih efisien karena teknik penembolokan tambahan. Di Windows XP dan Windows 2000, aplikasi tidak memiliki alasan untuk memanggil RpcEpResolveBinding.

Persyaratan


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