ADVF Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
| Name | Value | Description |
|---|---|---|
| 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_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). |
| ADVF_ONLYONCE | 4 | Requests that the object make only one change notification or cache update before deleting the connection. |
| ADVFCACHE_NOHANDLER | 8 | Synonym for ADVFCACHE_FORCEBUILTIN, which is used more often. |
| ADVFCACHE_FORCEBUILTIN | 16 | This value is used by DLL object applications and object handlers that perform the drawing of their objects. |
| ADVFCACHE_ONSAVE | 32 | For cache connections, this flag updates the cached representation only when the object containing the cache is saved. |
| ADVF_DATAONSTOP | 64 | For data advisory connections, assures accessibility to data. |
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.
