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


IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Метод

Определение

Создает соединение между объектом данных и приемником уведомлений. Этот метод вызывается объектом, который поддерживает приемник уведомлений и позволяет уведомлять приемник об изменениях в данных объекта.

public:
 int DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ adviseSink, [Runtime::InteropServices::Out] int % connection);
public int DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink adviseSink, out int connection);
abstract member DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

Параметры

pFormatetc
FORMATETC

Структура FORMATETC, переданная ссылкой, определяющая формат, целевое устройство, аспект и среду передачи, которые будут использоваться для будущих уведомлений.

advf
ADVF

Одно из значений ADVF, задающее группу флагов для контролирования вспомогательного соединения.

adviseSink
IAdviseSink

Указатель на интерфейс IAdviseSink в приемнике уведомлений, который будет получать уведомления об изменениях.

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

Комментарии

Дополнительные сведения см. в разделе Метод IDataObject::D Advise.

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