Fungsi RpcServerUnregisterIf (rpcdce.h)

Artikel
03/15/2023

Fungsi RpcServerUnregisterIf menghapus antarmuka dari registri pustaka run-time RPC.

Sintaks

RPC_STATUS RpcServerUnregisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  unsigned int  WaitForCallsToComplete
);

Parameter

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 .

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 yang terdaftar sebelumnya dari registri.

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

WaitForCallsToComplete

Bendera yang menunjukkan apakah akan segera menghapus antarmuka dari registri atau menunggu hingga semua panggilan saat ini selesai.

Tentukan nilai nol untuk mengalihkan panggilan yang sedang berlangsung dan segera menghapus antarmuka dari registri. Tentukan nilai bukan nol untuk menunggu hingga semua panggilan aktif selesai.

Mengembalikan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_UNKNOWN_MGR_TYPE	Jenis manajer tidak diketahui.
RPC_S_UNKNOWN_IF	Antarmuka tidak diketahui.

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

Keterangan

Server memanggil RpcServerUnregisterIf untuk menghapus hubungan antara antarmuka dan manajer EPV. Untuk menentukan manajer EPV yang akan dihapus dalam parameter MgrTypeUuid , berikan nilai UUID jenis yang ditentukan dalam panggilan ke RpcServerRegisterIf. Setelah dihapus dari registri, antarmuka tidak lagi tersedia untuk aplikasi klien.

Ketika antarmuka dihapus dari registri, pustaka run-time RPC berhenti menerima panggilan baru untuk antarmuka tersebut. Panggilan yang saat ini dijalankan pada antarmuka diizinkan untuk diselesaikan, termasuk panggilan balik.

Tabel berikut ini meringkas perilaku RpcServerUnregisterIf.

IfSpec	MgrTypeUuid	Aktivitas
Non-null	Non-null	Menghapus dari registri EPV manajer yang terkait dengan parameter yang ditentukan.
Non-null	NULL	Menghapus semua EPV manajer yang terkait dengan parameter IfSpec .
NULL	Non-null	Menghapus semua EPV manajer yang terkait dengan parameter MgrTypeUuid .
NULL	NULL	Menghapus semua EPV manajer. Panggilan ini memiliki efek mencegah server menerima panggilan prosedur jarak jauh baru karena semua EPV manajer untuk semua antarmuka telah dibatalkan pendaftarannya.

Catatan Jika nilai IfSpecadalah NULL, fungsi ini akan membiarkan antarmuka mendengarkan otomatis terdaftar. Antarmuka mendengarkan otomatis harus dihapus dari registri satu per satu. Lihat RpcServerRegisterIfEx untuk detail selengkapnya.

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