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
RPC_S_OK	Panggilan berhasil.

 

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

 

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

Lihat juga

RpcSmAllocate

RpcSmFree

RpcSmSetThreadHandle