Fungsi RpcMgmtEpUnregister (rpcdce.h)
[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 |
---|---|
|
Panggilan berhasil. |
|
Tidak dapat melakukan operasi yang diminta. |
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.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | rpcdce.h (termasuk Rpc.h) |
Pustaka | Rpcrt4.lib |
DLL | Rpcrt4.dll |