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

Определение

Пространство имен:
System.Runtime.InteropServices.ComTypes
Сборки:
netstandard.dll, System.Runtime.InteropServices.dll
Сборка:
System.Runtime.InteropServices.dll
Сборка:
System.dll
Сборка:
netstandard.dll
Исходный код:
IDataObject.cs
Исходный код:
IDataObject.cs
Исходный код:
HandleCollector.cs

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

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). Если это значение равно нулю, подключение не было установлено. Этот параметр передается неинициализирован.

Возвращаемое значение

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.

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