Fungsi RpcSsDestroyClientContext (rpcndr.h)
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.
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 |