Fonction RpcSmSetThreadHandle (rpcndr.h)
La fonction RpcSmSetThreadHandle définit un handle de thread pour l’environnement de gestion de la mémoire stub.
Syntaxe
RPC_STATUS RpcSmSetThreadHandle(
RPC_SS_THREAD_HANDLE Id
);
Paramètres
Id
Handle de thread retourné par un appel à RpcSmGetThreadHandle.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
Remarques
Une application appelle RpcSmSetThreadHandle 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 pour l’environnement de gestion de la mémoire stub appelle RpcSmGetThreadHandle pour obtenir 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 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 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.
Notez que RpcSmSetThreadHandle est généralement appelé par un thread généré par une procédure de gestionnaire de serveur. Le stub configure l’environnement de gestion de la mémoire pour la procédure de gestionnaire, et le responsable appelle RpcSmGetThreadHandle pour obtenir un handle de thread. Ensuite, chaque thread généré appelle RpcSmGetThreadHandle pour accéder à l’environnement de gestion de la mémoire du responsable.
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 |