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

Статья
08/25/2023

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

Синтаксис

RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
  RPC_STATUS *pStatus
);

Параметры

pStatus

Указатель на возвращенное состояние.

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.

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

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

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

RpcSmSetThreadHandle

Share via