Fungsi RpcSsSetThreadHandle (rpcndr.h)
Fungsi RpcSsSetThreadHandle menetapkan handel utas untuk lingkungan memori–manajemen stub.
void RpcSsSetThreadHandle(
RPC_SS_THREAD_HANDLE Id
);
Id
Handel utas dikembalikan oleh panggilan ke RpcSsGetThreadHandle.
Tidak ada
Aplikasi memanggil RpcSsSetThreadHandle untuk mengatur handel utas untuk lingkungan memori–manajemen stub. Utas yang digunakan untuk mengelola memori untuk lingkungan memori–manajemen stub memanggil RpcSsGetThreadHandle untuk mendapatkan handel untuk lingkungan memorinya. Dengan cara ini, utas lain yang memanggil RpcSsSetThreadHandle dengan menggunakan handel ini kemudian dapat menggunakan lingkungan manajemen memori yang sama.
Handel utas yang sama harus digunakan oleh beberapa utas yang memanggil RpcSsAllocate dan RpcSsFree untuk mengelola memori yang sama. Sebelum menelurkan utas baru untuk mengelola memori yang sama, utas yang menetapkan lingkungan manajemen memori (utas induk) memanggil RpcSsGetThreadHandle untuk mendapatkan handel utas untuk lingkungan ini. Kemudian, utas yang ditelurkan memanggil RpcSsSetThreadHandle dengan handel yang disediakan oleh utas induk.
Biasanya, utas yang dihasilkan oleh prosedur manajer server memanggil RpcSsSetThreadHandle. Stub menyiapkan lingkungan manajemen memori untuk prosedur manajer, dan manajer memanggil RpcSsGetThreadHandle untuk mendapatkan handel utas. Kemudian, setiap utas yang ditelurkan memanggil RpcSsGetThreadHandle untuk mendapatkan akses ke lingkungan manajemen memori manajer.
Utas juga dapat memanggil RpcSsGetThreadHandle dan RpcSsSetThreadHandle untuk menyimpan dan memulihkan lingkungan manajemen memorinya.
| 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 |