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

Статья
03/15/2023

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

Синтаксис

void RpcSsSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Параметры

Id

Дескриптор потока, возвращаемый вызовом RpcSsGetThreadHandle.

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

None

Remarks

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

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

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

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

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

Требования

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

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

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