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.

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