DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает соединение между объектом данных и приемником уведомлений. Этот метод вызывается объектом, который поддерживает приемник уведомлений и позволяет уведомлять приемник об изменениях в данных объекта.
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 ^ pAdvSink, [Runtime::InteropServices::Out] int % pdwConnection) = 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 pAdvSink, out int pdwConnection);
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
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, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdvise
Параметры
- pFormatetc
- FORMATETC
Структура FORMATETC, переданная ссылкой, определяющая формат, целевое устройство, аспект и среду передачи, которые будут использоваться для будущих уведомлений.
- advf
- ADVF
Одно из значений ADVF, задающее группу флагов для контролирования вспомогательного соединения.
- pAdvSink
- IAdviseSink
Указатель на интерфейс IAdviseSink в приемнике уведомлений, который будет получать уведомления об изменениях.
- pdwConnection
- Int32
При возвращении данного метода содержит указатель на маркер DWORD, определяющий это соединение. Позднее этот маркер можно использовать для удаления вспомогательного соединения, передав его в DUnadvise(Int32). Если это значение равно нулю, соединение не было установлено. Этот параметр передается неинициализированным.
Возвращаемое значение
Этот метод поддерживает стандартные возвращаемые значения E_INVALIDARG, E_UNEXPECTED и E_OUTOFMEMORY, а также следующие.
Значение | Описание: |
---|---|
S_OK | Было создано соединение для получения рекомендаций. |
E_NOTIMPL | Этот метод не был реализован в объекте данных. |
DV_E_LINDEX | Недопустимое значение для lindex; в настоящий момент поддерживается только значение -1. |
DV_E_FORMATETC | Недопустимое значение для параметра pFormatetc .
|
OLE_E_ADVISENOTSUPPORTED | Объект данных не поддерживает уведомление об изменении. |
Реализации
Комментарии
Этот член представляет собой явную реализацию члена интерфейса. Он может использоваться, только когда объект класса DataObject приведен к типу интерфейса IDataObject.