Fungsi RpcSsDestroyClientContext (rpcndr.h)

  • Artikel

Fungsi RpcSsDestroyClientContext menghancurkan handel konteks yang tidak lagi diperlukan oleh klien, tanpa menghubungi server.

Sintaks

void RpcSsDestroyClientContext(
  void **ContextHandle
);

Parameter

ContextHandle

Handel konteks yang akan dihancurkan. Handel diatur ke NULL sebelum RpcSsDestroyClientContext kembali.

Nilai kembali

RpcSsDestroyClientContext tidak memiliki nilai pengembalian.

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

Keterangan

RpcSsDestroyClientContext digunakan oleh aplikasi klien untuk mengklaim kembali sumber daya memori yang digunakan untuk mempertahankan handel konteks pada klien. Fungsi ini digunakan ketika ContextHandle tidak lagi valid, seperti ketika kegagalan komunikasi telah terjadi dan server tidak lagi tersedia. Handel konteks diatur ke NULL. Fungsi RpcSsDestroyClientContext menyediakan fungsionalitas yang sama dengan fungsi RpcSmDestroyClientContext . Fungsi ini tidak memanggil proses run-down handel konteks server.

Jangan gunakan RpcSsDestroyClientContext untuk mengganti fungsi server yang menutup handel konteks.

Fungsi RpcSsDestroyClientContext dapat memberikan pengecualian RPC_X_SS_CONTEXT_MISMATCH jika handel konteks yang diteruskan ke fungsi tersebut tidak valid. Aplikasi tidak boleh meneruskan handel konteks yang tidak valid ke fungsi ini. Jika pengecualian dilemparkan, itu menunjukkan kesalahan dalam kode panggilan, dan karenanya harus diselidiki dan diperbaiki.

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 rpcndr.h (termasuk Rpc.h)
Pustaka Rpcrt4.lib
DLL Rpcrt4.dll

Lihat juga

RpcBindingReset

RpcSmDestroyClientContext