Fonction RpcSsGetThreadHandle (rpcndr.h)

Article
03/04/2024

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
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 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.

RemarqueRpcSsGetThreadHandle déclenche des exceptions, tandis que RpcSmGetThreadHandle retourne le code d’erreur.

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

Share via