Partager via


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
RPC_S_OK
L’appel a réussi.
 
Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.
 

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

Voir aussi

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle