Fungsi RpcMgmtStopServerListening (rpcdce.h)

  • Artikel

Fungsi RpcMgmtStopServerListening memberi tahu server untuk berhenti mendengarkan panggilan prosedur jarak jauh. Fungsi ini tidak akan memengaruhi antarmuka mendengarkan otomatis. Lihat RpcServerRegisterIfEx untuk detail selengkapnya.

Sintaks

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

Parameter

Binding

Untuk mengarahkan aplikasi jarak jauh agar berhenti mendengarkan panggilan prosedur jarak jauh, tentukan handel pengikatan server untuk aplikasi tersebut. Untuk mengarahkan aplikasi (lokal) Anda sendiri agar berhenti mendengarkan panggilan prosedur jarak jauh, tentukan nilai NULL.

Menampilkan nilai

Nilai Makna
RPC_S_OK
 Panggilan berhasil.
RPC_S_INVALID_BINDING
 Handel pengikatan tidak valid.
RPC_S_WRONG_KIND_OF_BINDING
 Ini adalah jenis pengikatan yang salah untuk operasi.
 
Catatan Untuk daftar kode kesalahan yang valid, lihat Nilai Pengembalian RPC.
 

Keterangan

Aplikasi memanggil fungsi RpcMgmtStopServerListening untuk mengarahkan server agar berhenti mendengarkan panggilan prosedur jarak jauh. Jika DontWaitTRUE, aplikasi harus memanggil RpcMgmtWaitServerListen untuk menunggu semua panggilan selesai.

Ketika menerima permintaan berhenti mendengarkan, pustaka run-time RPC berhenti menerima panggilan prosedur jarak jauh baru untuk semua antarmuka terdaftar. Menjalankan panggilan diizinkan untuk diselesaikan, termasuk panggilan balik. Setelah semua panggilan selesai, fungsi ini menandakan fungsi RpcServerListen bahwa fungsi ini harus berhenti mendengarkan dan kembali ke pemanggil. Jika parameter DontWaitrpcServerListen diatur ke TRUE, aplikasi memanggil RpcMgmtWaitServerListen agar semua panggilan yang tersisa selesai.

Catatan Dari sisi klien, RpcMgmtStopServerListening dinonaktifkan secara default. Untuk mengaktifkan fungsi ini, buat fungsi otorisasi di aplikasi server Anda yang mengembalikan TRUE (untuk memungkinkan pematian jarak jauh) setiap kali RpcMgmtStopServerListening dipanggil. Gunakan RpcMgmtSetAuthorizationFn untuk memberi klien akses ke fungsi manajemen.
 
Server harus mendengarkan panggilan prosedur jarak jauh agar fungsi ini berhasil. Jika server tidak mendengarkan, fungsi gagal.

Persyaratan

   
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

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx