RpcSsSetThreadHandle, fonction (rpcndr.h)
La fonction RpcSsSetThreadHandle définit un handle de thread pour l’environnement de gestion de la mémoire stub.
Syntaxe
void RpcSsSetThreadHandle(
RPC_SS_THREAD_HANDLE Id
);
Paramètres
Id
Handle de thread retourné par un appel à RpcSsGetThreadHandle.
Valeur de retour
None
Remarques
Une application appelle RpcSsSetThreadHandle pour définir un handle de thread pour l’environnement de gestion de la mémoire stub. Un thread utilisé pour gérer la mémoire de l’environnement de gestion de la mémoire stub appelle RpcSsGetThreadHandle pour obtenir 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 afin de 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, un thread généré par une procédure de gestionnaire de serveur appelle RpcSsSetThreadHandle. Le stub configure l’environnement de gestion de la mémoire pour la procédure du gestionnaire, et le responsable appelle RpcSsGetThreadHandle pour obtenir un handle de thread. Ensuite, chaque thread généré appelle RpcSsGetThreadHandle pour accéder à l’environnement de gestion de la mémoire du responsable.
Un thread peut également appeler RpcSsGetThreadHandle et RpcSsSetThreadHandle pour enregistrer et restaurer son environnement de gestion de la mémoire.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | rpcndr.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |