Поделиться через


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 объект данных не поддерживает уведомление об изменениях.

Реализации

Применяется к