Fungsi RpcEpUnregister (rpcdce.h)

Artikel
2024-03-01

Fungsi RpcEpUnregister menghapus informasi alamat server dari database peta titik akhir lokal.

Sintaks

RPC_STATUS RpcEpUnregister(
  RPC_IF_HANDLE      IfSpec,
  RPC_BINDING_VECTOR *BindingVector,
  UUID_VECTOR        *UuidVector
);

Parameter

IfSpec

Antarmuka untuk membatalkan pendaftaran dari database peta titik akhir lokal.

BindingVector

Penunjuk ke vektor handel pengikatan untuk membatalkan pendaftaran.

UuidVector

Arahkan ke vektor opsional UUID objek untuk membatalkan pendaftaran. Aplikasi server membangun vektor ini. RpcEpUnregister membatalkan pendaftaran semua elemen database peta titik akhir yang cocok dengan parameter IfSpec dan BindingVector yang ditentukan dan UUID objek.

Nilai parameter null menunjukkan tidak ada UUID objek untuk membatalkan pendaftaran.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_NO_BINDINGS	Tidak ada pengikatan.
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

Fungsi RpcEpUnregister menghapus elemen dari database peta titik akhir host lokal. Aplikasi server memanggil fungsi ini hanya ketika server telah mendaftarkan titik akhir sebelumnya dan server ingin menghapus informasi alamat tersebut dari database peta titik akhir.

Secara khusus, RpcEpUnregister memungkinkan aplikasi server untuk menghapus elemen database peta titik akhirnya sendiri (informasi alamat server) berdasarkan spesifikasi antarmuka atau pada spesifikasi antarmuka dan UUID objek dari sumber daya yang ditawarkan.

Server memanggil fungsi RpcServerInqBindings untuk mendapatkan parameter BindingVector yang diperlukan. Untuk membatalkan pendaftaran titik akhir yang dipilih, server dapat memangkas vektor pengikatan sebelum memanggil fungsi ini.

RpcEpUnregister membuat lintas produk dari parameter IfSpec, BindingVector, dan UuidVector dan menghapus setiap elemen dalam lintas produk dari database peta titik akhir.

Persyaratan

Persyaratan	Nilai
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

Lihat juga

RpcEpRegister

RpcEpRegisterNoReplace

RpcNsBindingUnexport

RpcServerInqBindings

Bagikan melalui