This documentation is archived and is not being maintained.

ADVF Enumeration

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

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  System.Runtime.InteropServices.ComTypes
Assembly:  System (in System.dll)

public enum ADVF

Member nameDescription
ADVF_NODATAFor data advisory connections (DAdvise or Advise), this flag requests the data object not to send data when it calls OnDataChange.
ADVF_PRIMEFIRSTRequests that the object not wait for the data or view to change before making an initial call to OnDataChange (for data or view advisory connections) or updating the cache (for cache connections).
ADVF_ONLYONCERequests that the object make only one change notification or cache update before deleting the connection.
ADVF_DATAONSTOPFor data advisory connections, assures accessibility to data.
ADVFCACHE_NOHANDLERSynonym for ADVFCACHE_FORCEBUILTIN, which is used more often.
ADVFCACHE_FORCEBUILTINThis value is used by DLL object applications and object handlers that perform the drawing of their objects.
ADVFCACHE_ONSAVEFor cache connections, this flag updates the cached representation only when the object containing the cache is saved.

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.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.