Поделиться через

Функция RpcSsGetThreadHandle (rpcndr.h)

  • Статья

Функция RpcSsGetThreadHandle возвращает дескриптор потока для среды управления памятью заглушки.

Синтаксис

RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();

Возвращаемое значение

Значение Значение
RPC_S_OK
 Вызов выполнен успешно.
 
Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.
 

Комментарии

Приложение вызывает RpcSsGetThreadHandle , чтобы получить дескриптор потока для среды управления памятью заглушки. Поток, используемый для управления памятью для среды управления памятью заглушки, использует RpcSsGetThreadHandle для получения дескриптора для своей среды памяти. Таким образом, другой поток, вызывающий RpcSsSetThreadHandle с помощью этого дескриптора, может использовать ту же среду управления памятью.

Один и тот же дескриптор потока должен использоваться несколькими потоками, вызывающими RpcSsAllocate и RpcSsFree , для управления одной и той же памятью. Перед созданием новых потоков для управления той же памятью поток, создавший среду управления памятью (родительский поток), вызывает RpcSsGetThreadHandle , чтобы получить дескриптор потока для этой среды. Затем созданные потоки вызывают RpcSsSetThreadHandle с дескриптором, предоставленным родительским потоком.

Как правило, процедура диспетчера сервера вызывает RpcSsGetThreadHandle перед созданием дополнительных потоков. Заглушка настраивает среду управления памятью для процедуры диспетчера, и диспетчер вызывает RpcSsGetThreadHandle , чтобы сделать эту среду доступной для других потоков.

Поток также может вызывать RpcSsGetThreadHandle и RpcSsSetThreadHandle для сохранения и восстановления среды управления памятью.

ПримечаниеRpcSsGetThreadHandle вызывает исключения, а RpcSmGetThreadHandle возвращает код ошибки.
 

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header rpcndr.h (включая Rpc.h)
Библиотека Rpcrt4.lib
DLL Rpcrt4.dll

См. также раздел

RpcSmGetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsSetThreadHandle