Fungsi RpcServerInterfaceGroupDeactivate (rpcdce.h)

Artikel
03/01/2024

Fungsi RpcServerInterfaceGroupDeactivate memberi tahu runtime RPC untuk mencoba menutup grup antarmuka yang diberikan, secara opsional membatalkan operasi jika ada aktivitas klien yang luar biasa.

Sintaks

RPC_STATUS RpcServerInterfaceGroupDeactivate(
  [in] RPC_INTERFACE_GROUP IfGroup,
  [in] unsigned long       ForceDeactivation
);

Parameter

[in] IfGroup

RPC_INTERFACE_GROUP dari RpcServerInterfaceGroupCreate yang menentukan grup antarmuka untuk dinonaktifkan

[in] ForceDeactivation

Jika TRUE, runtime RPC harus mengabaikan aktivitas klien dan secara tanpa syarat menonaktifkan grup antarmuka. Jika FALSE, operasi harus dibatalkan jika aktivitas baru terjadi.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_SERVER_TOO_BUSY	ForceDeactivationadalah FALSE dan ada aktivitas klien yang luar biasa.

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

Keterangan

RpcServerInterfaceGroupDeactivate digunakan oleh aplikasi server untuk membatalkan pendaftaran antarmuka dan titik akhir dalam grup antarmuka. Ini melakukan sebagian besar pekerjaan pematian yang perlu dilakukan aplikasi server RPC. Ini melakukan operasi berikut:

Membatalkan pendaftaran titik akhir dan antarmuka dari pemeta titik akhir RPC.
Membatalkan pendaftaran titik akhir dari runtime server.
Membatalkan pendaftaran antarmuka dari runtime server.
Memberi tahu runtime untuk berhenti mendengarkan panggilan jika tidak ada antarmuka lain.

Jika ForceDeactivationFALSE, RpcServerInterfaceGroupDeactivate hanya akan menonaktifkan grup antarmuka jika tidak ada aktivitas klien yang luar biasa. Jika aktivitas baru tiba selama proses pennonaktifkanan, RPC_S_SERVER_TOO_BUSY dikembalikan. Dalam hal ini, operasi digulung balik dan grup antarmuka akan terus menerima dan mengirimkan panggilan.

Jika ForceDeactivationTRUE, RpcServerInterfaceGroupDeactivate tidak gagal.

Aplikasi layanan dapat memanggil RpcServerInterfaceGroupDeactivate dengan ForceDeactivation diatur ke FALSE dari fungsi panggilan balik diam mereka RpcServerInterfaceGroupCreate. Ketika digunakan bersama dengan pemicu mulai layanan RPC, ini memungkinkan mereka untuk berhenti dengan aman tanpa kehilangan panggilan dari klien potensial.

Persyaratan

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

Lihat juga

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupInqBindings

Bagikan melalui