System.Runtime.InteropServices.ComTypes.ADVF Enumeration

Specifies the requested behavior when setting up an advise sink or a caching connection with an object.

Syntax

[System.Flags]
public enum ADVF

Remarks

For additional information about ADVF, see the MDSN library.

The common language runtime throws an exception when a COM method in native code returns an HRESULT. For more information, see How to: Map HRESULTs and Exceptions.

Members

Member NameDescription
ADVF_DATAONSTOP

For data advisory connections, assures accessibility to data.

ADVF_NODATA

For data advisory connections (IDataObject.DAdvise(FORMATETC@, ADVF, IAdviseSink, Int32@) or IConnectionPoint.Advise(object, Int32@)), this flag requests the data object not to send data when it calls IAdviseSink.OnDataChange(FORMATETC@, STGMEDIUM@).

ADVF_ONLYONCE

Requests that the object make only one change notification or cache update before deleting the connection.

ADVF_PRIMEFIRST

Requests that the object not wait for the data or view to change before making an initial call to IAdviseSink.OnDataChange(FORMATETC@, STGMEDIUM@) (for data or view advisory connections) or updating the cache (for cache connections).

ADVFCACHE_FORCEBUILTIN

This value is used by DLL object applications and object handlers that perform the drawing of their objects.

ADVFCACHE_NOHANDLER

Synonym for ADVF.ADVFCACHE_FORCEBUILTIN, which is used more often.

ADVFCACHE_ONSAVE

For cache connections, this flag updates the cached representation only when the object containing the cache is saved.

Requirements

Namespace: System.Runtime.InteropServices.ComTypes
Assembly: System (in System.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0