IUIFramework：：InvalidateUICommand 方法 (uiribbon.h)
使 Windows 功能區架構 Command 屬性、值或狀態失效。
語法
HRESULT InvalidateUICommand(
[in] UINT32 commandId,
[in] UI_INVALIDATIONS flags,
[in] const PROPERTYKEY *key
);
參數
[in] commandId
類型： UINT32
命令的標識碼，其指定於標記資源檔中。
[in] flags
類型： UI_INVALIDATIONS
識別要失效之命令的哪個 層面 。
注意 傳遞 UI_INVALIDATIONS_ALLPROPERTIES 會使系結至命令的所有屬性失效，包括值和狀態。
[in] key
類型： const PROPERTYKEY*
命令屬性或狀態的屬性索引鍵。 此參數可以是 Null。
傳回值
類型： HRESULT
如果成功，則傳回S_OK;否則，下列清單中的錯誤值。
| 值 | 描述 |
|---|---|
| E_INVALIDARG | 已提供 索引鍵 的無效值。 |
| E_FAIL | 作業失敗。 所有命令都無法失效，或不支援任何指定的屬性。 |
備註
功能區架構標記中定義的資源會儲存在將標記檔案編譯成二進位格式時所建立的資源數據表中。 資源失效之後，就無法從標記資源數據表中恢復資源。
失效之後，架構會查詢主應用程式以取得資源詳細數據。
當 Command 值無效時， (旗標 包含索引 鍵 的值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 |