RpcSmGetThreadHandle, fonction (rpcndr.h)
La fonction RpcSmGetThreadHandle retourne un handle de thread, ou NULL, pour l’environnement de gestion de la mémoire stub.
Syntaxe
RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
RPC_STATUS *pStatus
);
Paramètres
pStatus
Pointeur vers le status retourné.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
Remarques
Les applications appellent RpcSmGetThreadHandle 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 de l’environnement de gestion de la mémoire stub utilise RpcSmGetThreadHandle pour recevoir un handle pour son environnement de mémoire. De cette façon, un autre thread qui appelle RpcSmSetThreadHandle à l’aide de ce handle peut ensuite utiliser le même environnement de gestion de la mémoire.
Le même handle de thread de gestion de la mémoire doit être utilisé par plusieurs threads appelant RpcSmAllocate et RpcSmFree 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 RpcSmGetThreadHandle pour obtenir un handle de thread pour cet environnement. Ensuite, les threads générés appellent RpcSmSetThreadHandle avec le nouveau handle de gestionnaire fourni par le thread parent.
En général, une procédure de gestionnaire de serveur appelle RpcSmGetThreadHandle avant que des threads supplémentaires soient générés. Le stub configure l’environnement de gestion de la mémoire pour la procédure du gestionnaire, et le responsable appelle RpcSmGetThreadHandle pour rendre cet environnement disponible pour les autres threads.
Un thread peut également appeler RpcSmGetThreadHandle et RpcSmSetThreadHandle 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 |