adVF 枚举 (objidl.h)
控制数据更改的缓存和通知的标志。
语法
typedef enum tagADVF {
ADVF_NODATA = 1,
ADVF_PRIMEFIRST = 2,
ADVF_ONLYONCE = 4,
ADVF_DATAONSTOP = 64,
ADVFCACHE_NOHANDLER = 8,
ADVFCACHE_FORCEBUILTIN = 16,
ADVFCACHE_ONSAVE = 32
} ADVF;
常量
ADVF_NODATA值：1 对于 (IDataObject：:D Advise 或 IDataAdviseHolder：：Advise) 的数据咨询连接，此标志请求数据对象在调用 IAdviseSink：：OnDataChange 时不发送数据。 更改通知的接收者稍后可以通过调用 IDataObject：：GetData 来请求数据。 数据对象可以通过在 STGMEDIUM 参数中传递TYMED_NULL来接受请求，也可以提供数据。 例如，数据对象可能有多个通知连接，但并非所有连接都指定ADVF_NODATA，在这种情况下，对象可能会向所有连接发送相同的通知。 无论容器的请求如何，其 IAdviseSink 实现都必须检查 STGMEDIUM 参数，因为它负责在媒体未TYMED_NULL时释放媒体。 对于 IOleCache：：Cache) (缓存连接，此标志请求不因对正在运行的对象所做的更改而更新缓存。 相反，容器将通过显式调用 IOleCache：：SetData 来更新缓存。 这种情况通常在缓存对象的标志性方面时发生。 ADVF_NODATA不是 IViewObject：：SetAdvise) (视图咨询连接的有效标志，它返回E_INVALIDARG。 |
ADVF_PRIMEFIRST值： 2 请求对象在对 IAdviseSink：：OnDataChange (进行初始调用之前不等待数据或视图更改，) 或更新缓存连接的缓存 () 。 与 ADVF_ONLYONCE 一起使用时，此参数提供异步 IDataObject：：GetData 调用。 |
ADVF_ONLYONCE值： 4 请求对象在删除连接前只进行一次更改通知或缓存更新。 ADVF_ONLYONCE发送一个数据或查看通知后自动删除通知连接。 咨询接收器仅接收一个 IAdviseSink 调用。 如果建立连接，则返回非零连接标识符，因此调用方可以在第一次更改通知之前使用它删除连接。 对于数据更改通知，ADVF_ONLYONCE和ADVF_PRIMEFIRST的组合实际上提供了异步 IDataObject：：GetData 调用。 与缓存一起使用时，ADVF_ONLYONCE在收到第一个 IAdviseSink：：OnDataChange 通知时仅更新缓存一次。 更新完成后，对象与缓存之间的咨询连接将断开连接。 咨询连接的源对象调用 Release 方法。 |
ADVF_DATAONSTOP值： 64 对于数据通知连接，请确保数据的可访问性。 此标志指示当数据对象关闭时，它应调用 ，提供与调用一起提供的数据。 通常，此值与 ADVF_NODATA 结合使用。 如果没有IAdviseSink：：OnDataChange 为值，则当没有数据的 OnDataChange 调用到达接收器时，源可能已完成其关闭，并且可能无法访问数据。 如果正在传递，指定此值的接收器应接受 OnDataChange 中提供的数据，因为它们可能无法再获得检索数据的机会。 对于缓存连接，此标志指示对象应在对象关闭过程中更新缓存。 ADVF_DATAONSTOP不是视图咨询连接的有效标志。 |
ADVFCACHE_NOHANDLER值： 8 ADVFCACHE_FORCEBUILTIN的同义词，使用频率更高。 |
ADVFCACHE_FORCEBUILTIN值： 16 此值由执行对象绘制的 DLL 对象应用程序和对象处理程序使用。 ADVFCACHE_FORCEBUILTIN指示 OLE 缓存演示文稿数据，以确保缓存中存在演示文稿。 此值不是数据或视图咨询连接的有效标志。 对于缓存连接，此标志缓存仅需要 OLE (附带的代码或基础操作系统) 提供的数据，以便通过 IDataObject：：GetData 或 IViewObject：:D raw 生成数据。 通过指定此值，容器可以确保即使对象或处理程序代码不可用，也可以检索数据。 |
ADVFCACHE_ONSAVE值： 32 对于缓存连接，此标志只在保存包含缓存的对象时更新缓存的表示形式。 当 OLE 对象从运行状态转换回加载状态 (时，缓存也会更新，因为后续保存操作需要重新运行对象) 。 此值不是数据或视图咨询连接的有效标志。 |
注解
对于数据或视图建议连接，在 IAdviseSink 实例与 IDataObject 或 IViewObject 实例之间建立连接时，容器使用 ADVF 常量。 这些连接是使用 IDataObject：:D Advise、 IDataAdviseHolder：：Advise 或 IViewObject：：SetAdvise 方法设置的。
对于缓存连接，常量在 IOleCache：：Cache 方法中指定，以指示容器关于对象应如何更新其缓存的请求。
这些常量也用于 STATDATA 结构的 advf 成员中。 IEnumSTATDATA 使用此结构来描述枚举的连接，advf 成员指示在建立咨询或缓存连接时指定的标志。 当 STATDATA 用于 IOleObject：：EnumAdvise 枚举器时， advf 成员是不确定的。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 标头 | objidl.h |