Функция RpcSsGetThreadHandle (rpcndr.h)
Функция RpcSsGetThreadHandle возвращает дескриптор потока для среды управления памятью заглушки.
Синтаксис
RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();
Возвращаемое значение
| Значение | Значение |
|---|---|
|
Вызов выполнен успешно. |
Комментарии
Приложение вызывает RpcSsGetThreadHandle , чтобы получить дескриптор потока для среды управления памятью заглушки. Поток, используемый для управления памятью для среды управления памятью заглушки, использует RpcSsGetThreadHandle для получения дескриптора для своей среды памяти. Таким образом, другой поток, вызывающий RpcSsSetThreadHandle с помощью этого дескриптора, может использовать ту же среду управления памятью.
Один и тот же дескриптор потока должен использоваться несколькими потоками, вызывающими RpcSsAllocate и RpcSsFree , для управления одной и той же памятью. Перед созданием новых потоков для управления той же памятью поток, создавший среду управления памятью (родительский поток), вызывает RpcSsGetThreadHandle , чтобы получить дескриптор потока для этой среды. Затем созданные потоки вызывают RpcSsSetThreadHandle с дескриптором, предоставленным родительским потоком.
Как правило, процедура диспетчера сервера вызывает RpcSsGetThreadHandle перед созданием дополнительных потоков. Заглушка настраивает среду управления памятью для процедуры диспетчера, и диспетчер вызывает RpcSsGetThreadHandle , чтобы сделать эту среду доступной для других потоков.
Поток также может вызывать RpcSsGetThreadHandle и RpcSsSetThreadHandle для сохранения и восстановления среды управления памятью.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | rpcndr.h (включая Rpc.h) |
| Библиотека | Rpcrt4.lib |
| DLL | Rpcrt4.dll |