IPlaybackControl, interface
Mise à jour : novembre 2007
Fonctionne dans Queued Components dans le cadre du traitement anormal des erreurs de lecture côté serveur et des échecs côté client du mécanisme de distribution Message Queuing.
Assembly : System.EnterpriseServices (dans System.EnterpriseServices.dll)
[GuidAttribute("51372AFD-CAE7-11CF-BE81-00AA00A2FA25")] [InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)] public interface IPlaybackControl
/** @attribute GuidAttribute("51372AFD-CAE7-11CF-BE81-00AA00A2FA25") */
/** @attribute InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown) */
public interface IPlaybackControl
public interface IPlaybackControl
La classe d'exception définie pour le composant dans le catalogue COM+ implémente à la fois IPlaybackControl et l'interface de la classe d'origine. Les implémentations de l'interface de la classe d'origine par la méthode permettent d'exécuter le traitement des exceptions pour les méthodes qui ont échoué dans la classe elle-même. Elles seront appelées après FinalClientRetry ou FinalServerRetry pour traiter les exceptions de la méthode appelée à l'origine.
Le Lecteur Queued Components appelle les méthodes de IPlaybackControl pour informer l'objet de gestion des exceptions qu'un message est sur le point d'être placé sur la file d'attente de repos final ou la file d'attente des lettres mortes. Le Lecteur Queued Components appelle alors la même méthode dans l'objet de gestion des exceptions ayant échoué dans l'appel de la méthode d'origine. L'objet de gestion des exceptions peut implémenter une solution de rechange, par exemple, en collectant des informations de diagnostic des problèmes ou en générant un objet ou un message qui signale le problème au client. Si l'application n'implémente pas IPlaybackControl, le message poison est placé sur la file d'attente de repos final ou la file d'attente des lettres mortes une fois que le Lecteur Queued Components a effectué le nombre de tentatives autorisé.
Un message poison est un message qui ne peut pas être traité pour une raison particulière, peut-être à la suite d'un problème de serveur ou de système de mise en file d'attente. La transaction est annulée et le message poison passe au début de la file d'attente. Lorsque le message est de nouveau supprimé de la file d'attente, le même cas se produit. Ce message continue à tourner en boucle tant que rien n'est fait pour corriger le problème. Le service Queued Components gère le message poison par le biais de toute une série de nouvelles tentatives. Après plusieurs tentatives infructueuses, le message est placé dans une file d'attente de repos final. Les messages poison demeurent dans la file d'attente de repos final tant qu'ils n'ont pas été déplacés manuellement à l'aide de l'utilitaire Message Mover de Queued Components.
Le cas du message poison peut être résolu par programme, à l'aide de la méthode FinalServerRetry, qui informe l'auteur du composant côté serveur que toutes les tentatives de lecture de l'activation différée ont échoué.
Si vous découvrez un message poison, vous pouvez le cas échéant être en mesure de résoudre rapidement la cause sous-jacente du problème. Par exemple, si le serveur est hors ligne pour une raison ou une autre, vous pouvez le remettre en ligne. Si vous ne pouvez pas résoudre le problème rapidement, vous pouvez générer automatiquement une autre transaction qui notifie au demandeur que la transaction ne s'est pas produite. Le demandeur peut effectuer une transaction de compensation qui inverse l'effet d'une transaction ayant été déjà validée.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
