OleDataObject::IDataObject::DAdvise Method (array<FORMATETC>^, UInt32, IAdviseSink^, UInt32)
Establishes a connection between the data object and a caller object implementing IAdviseSink.
Assembly: Microsoft.VisualStudio.Shell.14.0 (in Microsoft.VisualStudio.Shell.14.0.dll)
private: virtual int DAdvise( array<FORMATETC>^ pFormatetc, unsigned int ADVF, IAdviseSink^ pAdvSink, [OutAttribute] unsigned int% pdwConnection ) sealed = IDataObject::DAdvise
Parameters
- pFormatetc
-
Type:
array<Microsoft.VisualStudio.OLE.Interop::FORMATETC>^
Pointer to a FORMATETC structure that defines the format, target device, aspect, and medium that will be used for future notifications. For example, one sink may want to know only when the bitmap representation of the data in the data object changes. Another sink may be interested in only the metafile format of the same object. Each advise sink is notified when the data of interest changes. This data is passed back to the advise sink when notification occurs.
- ADVF
-
Type:
System::UInt32
DWORD that specifies a group of flags for controlling the advisory connection. Valid values are from the enumeration ADVF. However, only some of the possible ADVF values are relevant for this method.
- pAdvSink
-
Type:
Microsoft.VisualStudio.OLE.Interop::IAdviseSink^
Pointer to the IAdviseSink interface on the advise sink that will receive the change notification.
- pdwConnection
-
Type:
System::UInt32
Pointer to a DWORD token that identifies this connection. You can use this token later to delete the advisory connection (by passing it to DUnadvise. If this value is zero, the connection was not established.