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)

<FlagsAttribute>
Public Enumeration ADVF

Member nameDescription
ADVF_DATAONSTOP

For data advisory connections, assures accessibility to data.

ADVF_NODATA

For data advisory connections (DAdvise or Advise), this flag requests the data object not to send data when it calls OnDataChange.

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 OnDataChange (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 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.

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.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Windows Phone
Available since 8.1
Return to top
Show: