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

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

  • Статья

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

Синтаксис

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Параметры

Id

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

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

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

Комментарии

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

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

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

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

Требования

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

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

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle