ADVF ADVF ADVF ADVF Enum

Definition

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.

public enum class ADVF
[System.Flags]
public enum ADVF
type ADVF = 
Public Enum ADVF
Inheritance
Attributes

Fields

ADVF_DATAONSTOP ADVF_DATAONSTOP ADVF_DATAONSTOP ADVF_DATAONSTOP 64

For data advisory connections, assures accessibility to data.

ADVF_NODATA ADVF_NODATA ADVF_NODATA ADVF_NODATA 1

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

ADVF_ONLYONCE ADVF_ONLYONCE ADVF_ONLYONCE ADVF_ONLYONCE 4

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

ADVF_PRIMEFIRST ADVF_PRIMEFIRST ADVF_PRIMEFIRST ADVF_PRIMEFIRST 2

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

ADVFCACHE_FORCEBUILTIN ADVFCACHE_FORCEBUILTIN ADVFCACHE_FORCEBUILTIN ADVFCACHE_FORCEBUILTIN 16

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

ADVFCACHE_NOHANDLER ADVFCACHE_NOHANDLER ADVFCACHE_NOHANDLER ADVFCACHE_NOHANDLER 8

Synonym for ADVFCACHE_FORCEBUILTIN, which is used more often.

ADVFCACHE_ONSAVE ADVFCACHE_ONSAVE ADVFCACHE_ONSAVE ADVFCACHE_ONSAVE 32

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

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.

Applies to