Fungsi RpcSmSetThreadHandle (rpcndr.h)

Fungsi RpcSmSetThreadHandle menetapkan handel utas untuk lingkungan memori–manajemen stub.

Sintaks

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parameter

Id

Handel utas dikembalikan oleh panggilan ke RpcSmGetThreadHandle.

Nilai kembali

Nilai	Makna
RPC_S_OK	Panggilan berhasil.

 

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

 

Keterangan

Aplikasi memanggil RpcSmSetThreadHandle untuk mengatur handel utas untuk lingkungan memori–manajemen stub. Utas yang digunakan untuk mengelola memori untuk lingkungan memori–manajemen stub memanggil RpcSmGetThreadHandle untuk mendapatkan 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 manajemen memori–utas 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.

Perhatikan bahwa RpcSmSetThreadHandle biasanya dipanggil oleh utas yang ditelurkan oleh prosedur manajer server. Stub menyiapkan lingkungan manajemen memori untuk prosedur manajer, dan manajer memanggil RpcSmGetThreadHandle untuk mendapatkan handel utas. Kemudian, setiap utas yang ditelurkan memanggil RpcSmGetThreadHandle untuk mendapatkan akses ke lingkungan manajemen memori manajer.

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

Lihat juga

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle