OleDataObject.IDataObject.DAdvise(FORMATETC[], UInt32, IAdviseSink, UInt32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает соединение между объектом данных и вызывающим объектом, реализующим IAdviseSink.
virtual int Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise(cli::array <Microsoft::VisualStudio::OLE::Interop::FORMATETC> ^ pFormatetc, System::UInt32 ADVF, Microsoft::VisualStudio::OLE::Interop::IAdviseSink ^ pAdvSink, [Runtime::InteropServices::Out] System::UInt32 % pdwConnection) = Microsoft::VisualStudio::OLE::Interop::IDataObject::DAdvise;
int IDataObject.DAdvise (Microsoft.VisualStudio.OLE.Interop.FORMATETC[] pFormatetc, uint ADVF, Microsoft.VisualStudio.OLE.Interop.IAdviseSink pAdvSink, out uint pdwConnection);
abstract member Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * uint32 * Microsoft.VisualStudio.OLE.Interop.IAdviseSink * uint32 -> int
override this.Microsoft.VisualStudio.OLE.Interop.IDataObject.DAdvise : Microsoft.VisualStudio.OLE.Interop.FORMATETC[] * uint32 * Microsoft.VisualStudio.OLE.Interop.IAdviseSink * uint32 -> int
Function DAdvise (pFormatetc As FORMATETC(), ADVF As UInteger, pAdvSink As IAdviseSink, ByRef pdwConnection As UInteger) As Integer Implements IDataObject.DAdvise
Параметры
- pFormatetc
- FORMATETC[]
Указатель на структуру FORMATETC, определяющую формат, целевое устройство, аспект и среду передачи, которые будут использоваться для будущих уведомлений. Например, одному приемнику может требоваться знать только об изменениях в растровом представлении данных в объекте данных. Другой приемник может быть заинтересован только в формате метафайла того же объекта. Каждый приемник уведомлений уведомляется при изменении интересующих его данных. Эти данные передаются назад в приемник уведомлений при возникновении уведомления.
- ADVF
- UInt32
DWORD, содержащий группу флагов для управления советами по подключению. Допустимые Значения получены из перечисления ADVF. Однако только некоторые из возможных значений ADVF релевантны для данного метода.
- pAdvSink
- IAdviseSink
Указатель на интерфейс IAdviseSink в приемнике уведомлений, который будет получать уведомления об изменениях.
- pdwConnection
- UInt32
Указатель к токену DWORD, определяющему это соединение. Позднее этот токен можно использовать для удаления вспомогательного соединения (передав его DUnadvise). Если это значение равно нулю, соединение не было установлено.
Возвращаемое значение
S_OK в случае успешного выполнения метода; в противном случае — код ошибки.