为何打开脱水结构化存储文件时Cloud File API标记需同步？

我将云文件API用作同步客户端并追踪版本历史，发现当通过以下调用打开脱水/仅云存储的结构化存储文件（如PowerPoint .ppt或Excel .xls）时，会收到文件内容已变更的通知：

StgOpenStorageEx(fullPath, STGM.STGM_DIRECT_SWMR | STGM.STGM_READWRITE | STGM_SHARE_DENY_WRITE, STGFMT_DOCFILE, default, default, default, IID_IStorage, out var iptr)

此时云筛选器API会标记该文件需要同步，CfUpdatePlaceholder(HFILE fileHandle, IntPtr fsMetadata, IntPtr fileIdentity, uint fileIdentityLength,CF_FILE_Range[]? dehydrateRangeArray, uint dehydrateRangeCount, CF_UPDATE_FLAGS updateFlags, ref long updateUsn, IntPtr overlapped)会被触发。

为什么针对这类特殊文件的读取操作会出现此情况？（补充：为何回调显示文件已修改但实际未发生任何修改？）

预期：打开结构化存储文件进行读取操作时，不应收到内容变更事件通知。

参考资料：

• 云筛选器API
• 结构化存储类型 和 StgOpenStorageEx函数

1. 打开模式与权限的核心影响 #

你使用的STGM_READWRITE权限+STGM_DIRECT_SWMR（单写多读直接模式）是主要诱因：

• 结构化存储（OLE文档格式）的底层实现中，即使是逻辑上的读取操作，当以STGM_READWRITE权限打开时，系统会默认预留写入权限，内部可能会更新文件的事务日志标记、锁定计数或元数据缓存——这些操作属于文件系统层面的写入动作，会被云筛选器API捕获并判定为“内容变更”。
• STGM_DIRECT_SWMR模式会绕过结构化存储的缓存层，直接操作磁盘上的文件，任何底层的微小写入（哪怕是元数据更新）都会被实时上报给云筛选器。

2. 脱水文件的水化特性 #

脱水（仅云存储）文件在打开时需要执行**部分水化（本地缓存生成）**操作：

• 结构化存储文件的打开过程需要读取文件的目录结构、索引信息，系统可能会将这些临时数据写入本地文件的预留区域，或者更新文件的USN（更新序列号）。云筛选器API会将这些水化过程中的写入动作判定为文件修改，触发CfUpdatePlaceholder回调。

3. 云筛选器的监测逻辑特性 #

云筛选器API的CfUpdatePlaceholder触发依据是文件系统的写入事件，而非用户主动的内容修改：

• 它不区分是用户主动编辑还是系统底层的元数据/缓存更新，只要有写入操作发生就会触发同步标记。这就是你实际没有修改内容，但回调显示文件已修改的原因。

解决方案建议 #

• 将打开权限从STGM_READWRITE改为STGM_READ，并移除STGM_DIRECT_SWMR（如果不需要单写多读的直接操作）：

  StgOpenStorageEx(fullPath, STGM.STGM_READ | STGM_SHARE_DENY_NONE, STGFMT_DOCFILE, default, default, default, IID_IStorage, out var iptr)
  

• 如果必须使用STGM_DIRECT_SWMR，则需要在云筛选器的回调中增加判断逻辑：忽略由结构化存储打开操作触发的、无实际内容变更的CfUpdatePlaceholder请求（可通过对比文件哈希或USN的变更类型来过滤）。

内容的提问来源于stack exchange，提问作者Chisom A