Bagikan melalui


Fungsi RpcServerUnregisterIf (rpcdce.h)

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

Lihat juga

RPC_MGR_EPV

Mendaftarkan Antarmuka

RpcServerRegisterIf

RpcServerRegisterIf2

RpcServerRegisterIfEx

RpcServerUnregisterIfEx