Bagikan melalui

Fungsi RpcServerInterfaceGroupActivate (rpcdce.h)

  • Artikel

Fungsi RpcServerInterfaceGroupActivate memberi tahu runtime server RPC untuk mendaftarkan antarmuka dan titik akhir grup antarmuka dan mulai mendengarkan panggilan.

Sintaks

RPC_STATUS RpcServerInterfaceGroupActivate(
  [in] RPC_INTERFACE_GROUP IfGroup
);

Parameter

[in] IfGroup

RPC_INTERFACE_GROUP dari RpcServerInterfaceGroupCreate yang menentukan grup antarmuka untuk diaktifkan.

Nilai kembali

Nilai Makna
RPC_S_OK
 Panggilan berhasil.
RPC_S_PROTSEQ_NOT_SUPPORTED
 Urutan protokol tidak didukung pada host ini.
RPC_S_INVALID_RPC_PROTSEQ
 Urutan protokol tidak valid.
RPC_S_INVALID_ENDPOINT_FORMAT
 Format titik akhir tidak valid.
RPC_S_OUT_OF_MEMORY
 Sistem kehabisan memori.
RPC_S_INVALID_SECURITY_DESC
 Deskriptor keamanan untuk titik akhir atau antarmuka tidak valid.
 
Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.
 

Keterangan

RpcServerInterfaceGroupActivate melakukan sebagian besar pekerjaan inisialisasi yang perlu dilakukan aplikasi server RPC. Ini melakukan operasi berikut:

  • Menginstruksikan runtime RPC untuk mulai mendengarkan panggilan.
  • Mendaftarkan titik akhir dengan runtime server.
  • Mendaftarkan antarmuka dengan runtime server.
  • Mendaftarkan titik akhir dan antarmuka dengan pemeta titik akhir RPC.

RpcServerInterfaceGroupActivate adalah atomik. Jika pada titik mana pun operasi gagal, item apa pun yang sebelumnya terdaftar akan dibatalkan.

Panggilan dapat dikirim ke aplikasi server sebelum fungsi ini kembali.

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

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings