能否为已存在的dispinterface添加方法？是否影响现有用户？

核心结论 #

可以为已有的dispinterface添加方法，但必须严格遵循兼容性规则，否则会对现有用户造成破坏。

dispinterface的特性基础 #

dispinterface基于IDispatch接口，依赖类型库（TYPELIB）定义方法/属性的元数据，而非固定的vtable内存布局。这使得它比vtable接口或双重接口更具扩展性——只要维护好DISPID（调度标识符）的映射关系，就可以安全扩展。

安全扩展的规则 #

要避免影响现有用户，添加新方法时必须遵守以下规则：

• 仅在末尾追加新方法：绝对不能在现有方法之间插入新方法，否则会打乱原有DISPID的顺序，导致依赖DISPID的客户端调用错误。
• 保留原有方法的元数据：不能修改现有方法的DISPID、参数列表、返回值或名称，确保旧客户端的调用路径完全不变。
• 分配新的唯一DISPID：新方法使用从未在该dispinterface中出现过的DISPID，建议从现有最大DISPID值递增分配。
• 更新类型库并维护版本兼容性：更新类型库时可以提升版本号，但旧版本的类型库仍需可用，供未升级的客户端使用。

对现有用户的潜在影响 #

针对「dispinterface用于事件、带类型库、进程外服务器」的场景，影响分情况讨论：

晚绑定客户端 #

这类客户端通过IDispatch::Invoke动态调用方法，依赖类型库查询DISPID或硬编码DISPID：

• 若客户端依赖类型库查询DISPID：只要服务器维护原有方法的DISPID不变，客户端完全不受影响——晚绑定会自动从类型库获取正确的标识符，调用原有方法。
• 若客户端硬编码了DISPID：只要原有方法的DISPID未被修改，客户端也能正常工作；但如果错误地改变了原有DISPID（比如插入新方法），会导致调用错位，触发错误（如调用旧方法却执行新方法，或参数不匹配报错）。

早绑定客户端 #

这类客户端编译时依赖旧类型库，生成了固定的调用逻辑（比如VB6的事件接收器包装类、MFC的IDispEventImpl实现）：

• 未重新编译的旧客户端：只要服务器保留原有方法的DISPID和顺序，它们可以正常运行，因为不会调用新方法，原有事件的触发逻辑不受影响。
• 重新编译的客户端：升级类型库后，需要适配新的事件方法，但这属于主动升级的场景，不属于「破坏现有用户」的范畴。

事件场景的特殊情况 #

当dispinterface用于事件时，服务器触发新事件时，现有客户端的sink接口未实现该方法：

• 进程外服务器中，客户端的IDispatch::Invoke会返回DISP_E_MEMBERNOTFOUND，这个错误通常只会导致新事件被忽略，不会引发客户端或服务器崩溃。
• 服务器的事件触发逻辑应容忍客户端不处理新事件，避免假设所有客户端都实现了新方法。

总结 #

只要严格遵循「末尾追加、保留原有元数据、维护DISPID映射」的规则，就可以安全地为已有的dispinterface添加方法，现有用户不会受到影响。反之，违反规则则可能导致客户端调用错误、事件触发失败甚至程序崩溃。

内容的提问来源于stack exchange，提问作者Alex Guteniev