IPlaybackControl Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Funktioner i köade komponenter i onormal hantering av uppspelningsfel på serversidan och fel på klientsidan i leveransmekanismen för Meddelandeköer.
public interface class IPlaybackControl
[System.Runtime.InteropServices.Guid("51372AFD-CAE7-11CF-BE81-00AA00A2FA25")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IPlaybackControl
[<System.Runtime.InteropServices.Guid("51372AFD-CAE7-11CF-BE81-00AA00A2FA25")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IPlaybackControl = interface
Public Interface IPlaybackControl
- Attribut
Kommentarer
Undantagsklassen som definierats för komponenten i COM+-katalogen implementerar både IPlaybackControl och gränssnittet för den ursprungliga klassen. Metodimplementeringarna för det ursprungliga klassgränssnittet används för att utföra undantagshanteringen för de misslyckade metoderna i själva klassen. De anropas efter FinalClientRetry eller FinalServerRetry för att bearbeta undantag för den metod som ursprungligen anropades.
Queued Components Player anropar metoderna IPlaybackControl för att informera undantagshanterarobjektet om att ett meddelande är på väg att placeras i den sista vilande eller obeställbara kön. Queued Components Player anropar sedan samma metod i undantagshanterarobjektet som misslyckades i det ursprungliga metodanropet. Undantagshanterarobjektet kan implementera ett alternativ, till exempel genom att samla in information om problemdiagnos eller generera ett objekt eller meddelande som informerar klienten om problemet. Om programmet inte implementerar IPlaybackControlplaceras giftmeddelandet i den slutliga vilo- eller obeställbara kön när Spelaren för köade komponenter töms på alla återförsök.
Ett giftmeddelande är ett meddelande som inte kan bearbetas av någon anledning, kanske på grund av ett problem med servern eller kösystemet. Transaktionen återställs och giftmeddelandet hamnar överst i kön. När meddelandet tas bort igen inträffar samma villkor. Det här meddelandet kan fortsätta att loopa på obestämd tid tills något har gjorts för att åtgärda problemet. Tjänsten Queued Components hanterar giftmeddelandet med hjälp av en serie återförsök. Efter flera misslyckade återförsök flyttas meddelandet till en slutlig vilande kö. Giftmeddelanden finns kvar i vilokön tills de flyttas manuellt med hjälp av verktyget Message Mover för köade komponenter.
Giftmeddelandesituationen kan också lösas programmatiskt med hjälp av FinalServerRetry metoden, som informerar komponentförfattaren på serversidan om att alla försök att spela upp den uppskjutna aktiveringen har misslyckats.
Om du upptäcker ett giftmeddelande kanske du snabbt kan lösa den underliggande orsaken till problemet. Om servern till exempel var offline av någon anledning kan du ta tillbaka servern online. Om du inte kan lösa problemet snabbt kan du automatiskt generera en annan transaktion som meddelar beställaren att transaktionen inte har inträffat. Beställaren kan sedan göra en kompenserande transaktion som upphäver effekten av en transaktion som redan har checkats in.
Metoder
| Name | Description |
|---|---|
| FinalClientRetry() |
Informerar komponenten för undantagshantering på klientsidan om att alla Message Queuing-försök att leverera meddelandet till servern avvisades och att meddelandet hamnade i Xact Dead Letter-kön på klientsidan. |
| FinalServerRetry() |
Informerar implementeringen av undantagsklassen på serversidan om att alla försök att spela upp den uppskjutna aktiveringen till servern har misslyckats och att meddelandet är på väg att flyttas till den sista vilande kön. |