使 Windows 功能区框架命令属性、值或状态失效。
语法
HRESULT InvalidateUICommand(
[in] UINT32 commandId,
[in] UI_INVALIDATIONS flags,
[in] const PROPERTYKEY *key
);
参数
[in] commandId
类型： UINT32
命令的 ID，在标记资源文件中指定。
[in] flags
类型： UI_INVALIDATIONS
标识要使命令的哪个 方面 失效。
注意 传递 UI_INVALIDATIONS_ALLPROPERTIES 会使绑定到命令的所有属性（包括值和状态）失效。
[in] key
类型： const PROPERTYKEY*
命令属性或状态的属性键。 此参数可以为 NULL。
返回值
类型： HRESULT
如果成功，则返回S_OK;否则，以下列表中的错误值。
| 值 | 说明 |
|---|---|
| E_INVALIDARG | 提供的 键 值无效。 |
| E_FAIL | 此操作失败。 所有命令都未能失效，或者不支持任何指定的属性。 |
注解
功能区框架标记中定义的资源存储在资源表中，该资源表是在将标记文件编译为二进制格式时创建的。 资源在失效后无法从标记资源表恢复。
失效后，框架会向主机应用程序查询资源详细信息。
当命令值无效时， (标志 包含UI_INVALIDATIONS_VALUE) 键 的值为 NULL。
如果多次调用 IUIFramework：：InvalidateUICommand ，并且每次调用中传递 的UI_INVALIDATIONS 值指定重叠属性（如 UI_INVALIDATIONS_STATE 和 UI_INVALIDATIONS_ALLPROPERTIES），则仅创建一个对主机应用程序的回调。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | uiribbon.h |
| DLL | Mshtml.dll |