Bagikan melalui


Fungsi RpcEpResolveBinding (rpcdce.h)

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

Lihat juga

RpcBindingFromStringBinding

RpcBindingReset

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingImportBegin

RpcNsBindingImportDone

RpcNsBindingImportNext