ClipboardObject.IDataObject.DAdvise Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает соединение между объектом буфера обмена и приемником рекомендаций. Этот метод вызывается объектом, который поддерживает приемник уведомлений и позволяет уведомлять приемник об изменениях в данных объекта.
virtual int System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ adviseSink, [Runtime::InteropServices::Out] int % connection) = System::Runtime::InteropServices::ComTypes::IDataObject::DAdvise;
int IDataObject.DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink adviseSink, out int connection);
override this.System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer Implements IDataObject.DAdvise
Параметры
- pFormatetc
- FORMATETC
Структура FORMATETC, переданная ссылкой, определяющая формат, целевое устройство, аспект и среду передачи, которые будут использоваться для будущих уведомлений.
- advf
- ADVF
Значение из перечисления ADVF , указывающее группу флагов для управления соединением рекомендаций.
- adviseSink
- IAdviseSink
Объект IAdviseSink , указывающий на приемник рекомендаций, который получит уведомление об изменении.
- connection
- Int32
Выходной параметр. При возврате этого метода этот параметр содержит маркер, который идентифицирует это подключение. Позднее этот маркер можно использовать для удаления вспомогательного соединения, передав его в IDataObject.DUnadvise(Int32). Если это значение равно нулю, соединение не было установлено. Этот параметр передается неинициализированным.
Возвращаемое значение
Этот метод поддерживает стандартные возвращаемые значения E_INVALIDARG, E_UNEXPECTED и E_OUTOFMEMORY, а также следующее: ValueDescriptionS_OKThe было создано консультативное подключение. E_NOTIMPLThis метод не реализован в данных, object.DV_E_LINDEXThere является недопустимым значением для lindex; в настоящее время supported.DV_E_FORMATETCThere является недопустимым значением pFormatetc
параметра только -1. OLE_E_ADVISENOTSUPPORTEDThe объект данных не поддерживает уведомление об изменениях.