Fungsi RpcMgmtEpUnregister (rpcdce.h)

Artikel
03/01/2024

[Fungsi ini hanya didukung pada Windows NT dan Windows Me/98/95; fungsi ini mengembalikan EP_S_CANT_PERFORM_OP pada versi Windows lainnya.]

Fungsi RpcMgmtEpUnregister menghapus informasi alamat server dari peta titik akhir.

Sintaks

RPC_STATUS RpcMgmtEpUnregister(
  RPC_BINDING_HANDLE EpBinding,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE Binding,
  UUID               *ObjectUuid
);

Parameter

EpBinding

Host yang elemen peta titik akhirnya tidak akan terdaftar. Untuk menghapus elemen dari host yang sama dengan aplikasi panggilan, aplikasi menentukan nilai NULL. Untuk menghapus elemen dari host lain, aplikasi menentukan handel pengikatan server untuk server apa pun yang berada di host tersebut. Perhatikan bahwa aplikasi dapat menentukan penanganan pengikatan yang sama dengan yang digunakan untuk melakukan panggilan prosedur jarak jauh lainnya.

IfId

Pengidentifikasi antarmuka untuk dihapus dari peta titik akhir.

Binding

Handel pengikatan untuk dihapus.

ObjectUuid

UUID objek opsional untuk dihapus. Nilai NULL menunjukkan tidak ada UUID objek untuk dihapus.

Nilai kembali

Menampilkan kode	Deskripsi
RPC_S_OK	Panggilan berhasil.
RPC_S_CANT_PERFORM_OP	Tidak dapat melakukan operasi yang diminta.

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

Keterangan

Fungsi RpcMgmtEpUnregister membatalkan pendaftaran elemen dari peta titik akhir. Program manajemen memanggil fungsi ini untuk menghapus alamat server yang tidak lagi tersedia, atau untuk menghapus alamat server yang mendukung objek yang tidak lagi ditawarkan.

Parameter EpBinding harus berupa pengikatan penuh. UUID objek yang terkait dengan parameter EpBinding harus nihil UUID. Menentukan UUID non-nihil menyebabkan fungsi gagal dengan kode status EPT_S_CANT_PERFORM_OP. Selain informasi host dan UUID objek, semua informasi dalam argumen ini diabaikan.

Aplikasi memanggil RpcMgmtEpEltInqNext untuk melihat elemen peta titik akhir lokal. Aplikasi kemudian dapat menghapus elemen menggunakan RpcMgmtEpUnregister.

Catatan Gunakan fungsi ini dengan hati-hati. Menghapus elemen dari peta titik akhir lokal dapat membuat server tidak tersedia untuk aplikasi klien yang belum memiliki handel pengikatan yang sepenuhnya terikat ke server.