Fungsi RpcSmGetThreadHandle (rpcndr.h)
Fungsi RpcSmGetThreadHandle mengembalikan handel utas, atau NULL, untuk lingkungan manajemen memori stub.
Sintaks
RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
RPC_STATUS *pStatus
);
Parameter
pStatus
Penunjuk ke status yang dikembalikan.
Nilai kembali
Nilai | Makna |
---|---|
|
Panggilan berhasil. |
Keterangan
Aplikasi memanggil RpcSmGetThreadHandle untuk mendapatkan handel utas untuk lingkungan memori–manajemen stub. Utas yang digunakan untuk mengelola memori untuk lingkungan memori–manajemen stub menggunakan RpcSmGetThreadHandle untuk menerima handel untuk lingkungan memorinya. Dengan cara ini, utas lain yang memanggil RpcSmSetThreadHandle dengan menggunakan handel ini kemudian dapat menggunakan lingkungan manajemen memori yang sama.
Handel utas manajemen memori yang sama harus digunakan oleh beberapa utas yang memanggil RpcSmAllocate dan RpcSmFree untuk mengelola memori yang sama. Sebelum menelurkan utas baru untuk mengelola memori yang sama, utas yang menetapkan lingkungan manajemen memori (utas induk) memanggil RpcSmGetThreadHandle untuk mendapatkan handel utas untuk lingkungan ini. Kemudian, utas yang ditelurkan memanggil RpcSmSetThreadHandle dengan handel manajer baru yang disediakan oleh utas induk.
Biasanya prosedur manajer server memanggil RpcSmGetThreadHandle sebelum utas tambahan muncul. Stub menyiapkan lingkungan manajemen memori untuk prosedur manajer, dan manajer memanggil RpcSmGetThreadHandle untuk membuat lingkungan ini tersedia untuk utas lainnya.
Utas juga dapat memanggil RpcSmGetThreadHandle dan RpcSmSetThreadHandle untuk menyimpan dan memulihkan lingkungan manajemen memorinya.
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 |