Интерфейс IPartDiscardControl (filterpipeline.h)

Конвейер фильтра поддерживает элемент управления отмены. Фильтры могут использовать этот объект, если они получают его из метода IXpsDocumentProvider::GetXpsPart. В некоторых случаях обработка этого объекта может просто включать перенаправление его в следующий фильтр с помощью метода IXpsDocumentConsumer::SendXpsUnknown.

Фильтры также могут создавать элементы управления отмены. Чтобы создать элемент управления отмены, фильтр должен создать объект, реализующий интерфейс IPartDiscardControl. Так как фильтр передает владение элементом управления отмены при отправке его в следующий фильтр, фильтр должен управлять временем существования элемента управления отмены. Если фильтр создает элемент управления отмены, библиотека DLL фильтра не должна выгружаться, пока не будет освобожден элемент управления отмены.

Наследство

Интерфейс IPartDiscardControl наследует от интерфейса IUnknown.

Методика

Интерфейс IPartDiscardControl имеет эти методы.

IPartDiscardControl::GetDiscardProperties Метод GetDiscardProperties получает свойства элемента управления отмены.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	filterpipeline.h (include Filterpipeline.h)