Fungsi RpcRevertToSelfEx (rpcdce.h)

Fungsi RpcRevertToSelfEx memungkinkan server untuk meniru klien dan kemudian kembali dalam operasi multithreaded di mana panggilan untuk meniru klien dapat berasal dari utas selain utas yang awalnya dikirim dari RPC.

Sintaks

RPC_STATUS RpcRevertToSelfEx(
  RPC_BINDING_HANDLE BindingHandle
);

Parameter

BindingHandle

Handel pengikatan pada server yang mewakili pengikatan ke klien yang ditiru oleh server. Nilai nol menentukan handel klien dari utas saat ini; dalam hal ini, fungsionalitas RpcRevertToSelfEx identik dengan fungsi RpcRevertToSelf .

Menampilkan nilai

Nilai	Makna
RPC_S_OK	Panggilan berhasil.
RPC_S_NO_CALL_ACTIVE	Server tidak memiliki klien untuk ditiru.
RPC_S_INVALID_BINDING	Handel pengikatan tidak valid.
RPC_S_WRONG_KIND_OF_BINDING	Ini adalah jenis pengikatan yang salah untuk operasi ini.
RPC_S_CANNOT_SUPPORT	Panggilan tidak didukung untuk sistem operasi ini, transportasi ini, atau subsistem keamanan ini.

 

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

 

Keterangan

Setelah memanggil RpcImpersonateClient dan menyelesaikan tugas apa pun yang memerlukan peniruan klien, server memanggil RpcRevertToSelfEx untuk mengakhiri peniruan identitas dan membangun kembali identitas keamanannya sendiri. Misalnya, pertimbangkan utas utama, yang disebut thread1, yang dikirim dari klien jarak jauh dan membangunkan utas pekerja, yang disebut thread2. Jika thread2 mengharuskan server meniru klien, server memanggil RpcImpersonateClient(THREAD1_CALL_HANDLE), melakukan tugas yang diperlukan, memanggil RpcRevertToSelfEx(THREAD1_CALL_HANDLE) untuk mengakhiri peniruan, lalu membangunkan thread1.

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

Peniruan Klien

RpcImpersonateClient

RpcRevertToSelf