IPartDiscardControl-Schnittstelle (filterpipeline.h)

Die Filterpipeline unterstützt das Verwerfen-Steuerelement. Filter können dieses Objekt verwenden, wenn sie es von der IXpsDocumentProvider::GetXpsPart-Methode abrufen. In einigen Fällen kann die Verarbeitung dieses Objekts nur das Weiterleiten an den nächsten Filter mit der IXpsDocumentConsumer::SendXpsUnknown-Methode umfassen.

Filter können auch Verwerfenssteuerelemente erstellen. Um ein Verwerfen-Steuerelement zu erstellen, muss der Filter ein Objekt erstellen, das die IPartDiscardControl-Schnittstelle implementiert. Da der Filter den Besitz des Verwerfen-Steuerelements überträgt, wenn es an den nächsten Filter gesendet wird, muss der Filter die Lebensdauer des Verwerfen-Steuerelements verwalten. Wenn ein Filter ein Verwerfen-Steuerelement erstellt, darf die Filter-DLL erst entladen werden, wenn das Verwerfen-Steuerelement freigegeben wurde.

Vererbung

Die IPartDiscardControl-Schnittstelle erbt von der IUnknown-Schnittstelle .

Methoden

Die IPartDiscardControl-Schnittstelle verfügt über diese Methoden.

IPartDiscardControl::GetDiscardProperties Die GetDiscardProperties-Methode ruft die Eigenschaften des Verwerfen-Steuerelements ab.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	filterpipeline.h (include Filterpipeline.h)