Fungsi RpcServerUnregisterIfEx (rpcdce.h)

Artikel
08/25/2023

Fungsi RpcServerUnregisterIfEx menghapus antarmuka dari registri pustaka run-time RPC. Fungsi ini memperluas fungsionalitas fungsi RpcServerUnregisterIf .

Sintaks

RPC_STATUS RpcServerUnregisterIfEx(
  [in] RPC_IF_HANDLE IfSpec,
  [in] UUID          *MgrTypeUuid,
  [in] int           RundownContextHandles
);

Parameter

[in] IfSpec

Antarmuka untuk dihapus dari registri.

Tentukan nilai null untuk menghapus semua antarmuka yang sebelumnya terdaftar dengan nilai UUID jenis yang ditentukan dalam parameter MgrTypeUuid .

[in] MgrTypeUuid

Arahkan ke UUID jenis vektor titik masuk manajer (EPV) untuk dihapus dari registri. Nilai MgrTypeUuid harus bernilai sama seperti yang disediakan dalam panggilan ke fungsi RpcServerRegisterIf , fungsi RpcServerRegisterIf2 , atau fungsi RpcServerRegisterIfEx .

Tentukan nilai null untuk menghapus antarmuka yang ditentukan dalam parameter IfSpec untuk semua UUID jenis terdaftar sebelumnya dari registri.

Tentukan UUID nihil untuk menghapus EPV manajer default yang dihasilkan MIDL dari registri. Dalam hal ini, semua manajer EPV yang terdaftar dengan UUID jenis non-nihil tetap terdaftar.

[in] RundownContextHandles

Menentukan apakah rundown dipanggil untuk handel konteks aktif. Jika bukan nol, rundown dipanggil setelah semua panggilan pada antarmuka selesai. Jika diatur ke nol, run time RPC mengasumsikan server telah menghancurkan bagian handel konteksnya dan tidak akan memanggil rutinitas rundown.

Nilai kembali

Mengembalikan status RPC. RpcServerUnregisterIfEx tidak gagal kecuali disediakan dengan nilai yang tidak valid.

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

Keterangan

Fungsi RpcServerUnregisterIfEx menunggu semua panggilan pada antarmuka tertentu selesai sebelum membatalkan pendaftaran handel konteks.

Fungsi RpcServerUnregisterIfEx memasok semua fungsionalitas yang disediakan dalam fungsi RpcServerUnregisterIf . Selain itu, fungsi RpcServerUnregisterIfEx membatalkan pendaftaran semua handel konteks yang didaftarkan oleh antarmuka yang diberikan. Antarmuka harus menggunakan atribut strict_context_handle , jika tidak, hasilnya tidak ditentukan.

RpcServerUnregisterIfEx adalah satu-satunya fungsi yang menyediakan pembongkaran DLL dengan aman dengan handel konteks aktif di luar proses pematian. Ini hanya tersedia di Windows XP dan versi Windows yang lebih baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll