ClipboardObject.IDataObject.DAdvise - метод

Статья
05/17/2015

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

Пространство имен: Microsoft.VisualStudio.Data.Framework
Сборка: Microsoft.VisualStudio.Data.Framework (в Microsoft.VisualStudio.Data.Framework.dll)

Синтаксис

'Декларация
Private Function DAdvise ( _
    ByRef pFormatetc As FORMATETC, _
    advf As ADVF, _
    adviseSink As IAdviseSink, _
    <OutAttribute> ByRef connection As Integer _
) As Integer Implements IDataObject.DAdvise

int IDataObject.DAdvise(
    ref FORMATETC pFormatetc,
    ADVF advf,
    IAdviseSink adviseSink,
    out int connection
)

private:
virtual int DAdvise(
    FORMATETC% pFormatetc, 
    ADVF advf, 
    IAdviseSink^ adviseSink, 
    [OutAttribute] int% connection
) sealed = IDataObject::DAdvise

private abstract DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int  
private override DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int

JScript не поддерживает явные реализации интерфейса.

Параметры

pFormatetc
Тип: FORMATETC%

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

advf
Тип: ADVF

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

adviseSink
Тип: IAdviseSink

Объект IAdviseSink, указывающего на консультативному приемнику, получающего уведомления об изменениях.

connection
Тип: Int32%

Выходной параметр. При возвращении данного метода содержит этот параметр — это токен, определяет это подключение. Позднее этот маркер можно использовать для удаления вспомогательного соединения, передав его в IDataObject.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.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Заметки

Этот метод делегирует вызов соответствующего DAdvise из пространства имен System.Runtime.InteropServices.ComTypes, высказывать объект буфера обмена существующего экземпляра IDataObject.

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ClipboardObject Класс

Microsoft.VisualStudio.Data.Framework - пространство имен

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