RpcSsDontSerializeContext, fonction (rpcdce.h)

  • Article

La fonction RpcSsDontSerializeContext désactive la sérialisation au moment de l’exécution de plusieurs appels distribués aux routines du gestionnaire de serveur sur le même handle de contexte. L’utilisation de cette fonction n’est pas recommandée. Les développeurs doivent utiliser la sérialisation du handle de contenu en mode mixte à la place. La section Voir aussi fournit des liens vers des fonctions plus appropriées.

Syntaxe

void RpcSsDontSerializeContext();

Valeur de retour

None

Notes

La fonction RpcSsDontSerializeContext empêche l’exécution de ce service de sérialisation, ce qui permet la distribution de plusieurs appels sur un handle de contexte donné. L’appel de cette fonction ne désactive pas entièrement la sérialisation : lorsqu’une panne de contexte se produit, votre routine d’exécution de contexte ne s’exécute pas tant que toutes les demandes clientes en suspens ne sont pas terminées. Les modifications apportées à l’état du handle de contexte, notamment la libération du handle de contexte, doivent continuer à être sérialisées.

Il est recommandé que, si votre application distribuée appelle la fonction RpcSsDontSerializeContext , l’appel soit effectué avant que le programme serveur commence à gérer les appels de procédure distante.

Note En règle générale, l’exécution RPC sérialise les appels sur le même handle de contexte distribué aux routines du gestionnaire de serveur. Les handles de contexte sont gérés par client et représentent généralement l’état côté serveur. Cela signifie que votre gestionnaire de serveur n’a pas à se protéger contre un autre thread du même client qui change le contexte ou contre le contexte en cours d’exécution pendant la distribution d’un appel.
 
Note Une fois qu’elle est appelée, la fonction RpcSsDontSerializeContext n’est pas réinitialisable pendant toute la durée du processus.
 

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête rpcdce.h
Bibliothèque Rpcrt4.lib
DLL Rpcrt4.dll

Voir aussi

Clients multithreads et descripteurs de contexte

RpcSsContextLockExclusive

RpcSsContextLockShared

Routine d’exécution du contexte du serveur

context_handle_noserialize

context_handle_serialize