Fonction RpcSsGetThreadHandle (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
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
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 des threads supplémentaires ne 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.
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 |