RpcSsGetThreadHandle, fonction (rpcndr.h)

La fonction RpcSsGetThreadHandle retourne un handle de thread pour l’environnement de gestion de la mémoire stub.

Syntaxe

RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();

Valeur retournée

Remarques

Une application appelle RpcSsGetThreadHandle pour obtenir un handle de thread pour l’environnement de gestion de la mémoire stub. Un thread utilisé pour gérer la mémoire pour l’environnement de gestion de la mémoire stub utilise RpcSsGetThreadHandle pour recevoir un handle pour son environnement de mémoire. De cette façon, un autre thread qui appelle RpcSsSetThreadHandle à l’aide de ce handle peut ensuite utiliser le même environnement de gestion de la mémoire.

Le même handle de thread doit être utilisé par plusieurs threads appelant RpcSsAllocate et RpcSsFree pour gérer la même mémoire. Avant de générer de nouveaux threads pour gérer la même mémoire, le thread qui a établi l’environnement de gestion de la mémoire (thread parent) appelle RpcSsGetThreadHandle pour obtenir un handle de thread pour cet environnement. Ensuite, les threads générés appellent RpcSsSetThreadHandle avec le handle fourni par le thread parent.

En règle générale, une procédure de gestionnaire de serveur appelle RpcSsGetThreadHandle avant que d’autres threads soient générés. Le stub configure l’environnement de gestion de la mémoire pour la procédure de gestionnaire, et le responsable appelle RpcSsGetThreadHandle pour rendre cet environnement disponible pour les autres threads.

Un thread peut également appeler RpcSsGetThreadHandle et RpcSsSetThreadHandle pour enregistrer et restaurer son environnement de gestion de la mémoire.

Spécifications

Voir aussi

RpcSmGetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsSetThreadHandle