ADVF Enum

Definition

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

This enumeration supports a bitwise combination of its member values.

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

Fields

ADVF_DATAONSTOP 64

For data advisory connections, assures accessibility to data.

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 4

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

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 16

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

ADVFCACHE_NOHANDLER 8

Synonym for ADVFCACHE_FORCEBUILTIN, which is used more often.

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