Fungsi RpcMgmtIsServerListening (rpcdce.h)

Artikel
03/15/2023

Fungsi RpcMgmtIsServerListening memberi tahu apakah server mendengarkan panggilan prosedur jarak jauh.

Sintaks

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

Parameter

Binding

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

Nilai kembali

Nilai	Makna
RPC_S_OK	Server mendengarkan panggilan prosedur jarak jauh.
RPC_S_NOT_LISTENING	Server tidak mendengarkan panggilan prosedur jarak jauh, atau antarmuka mendengarkan secara otomatis.
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.

Fungsi RpcMgmtIsServerListening mengembalikan hasil yang benar hanya untuk antarmuka yang tidak mendengarkan secara otomatis. Jika aplikasi server mendengarkan secara otomatis dan memanggil fungsi RpcMgmtIsServerListening , RpcMgmtIsServerListening mengembalikan RPC_SERVER_NOT_LISTENING, namun server mungkin mendengarkan, dan panggilan RPC berikutnya mungkin berhasil.

Keterangan

Aplikasi memanggil fungsi RpcMgmtIsServerListening untuk menentukan apakah server yang ditentukan dalam parameter Pengikatan mendengarkan panggilan prosedur jarak jauh.

Fungsi RpcMgmtIsServerListening mengembalikan nilai RPC_S_OK jika server telah memanggil RpcServerListen.

Server harus mendengarkan panggilan prosedur jarak jauh agar fungsi ini berhasil. Jika server tidak mendengarkan, fungsi gagal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	rpcdce.h (termasuk Rpc.h)
Pustaka	Rpcrt4.lib
DLL	Rpcrt4.dll

Lihat juga

RpcEpResolveBinding

RpcServerListen

Bagikan melalui