Share via


IPropertyStore::Commit 方法 (propsys.h)

進行變更之後,這個方法會儲存變更。

Syntax

HRESULT Commit();

傳回值

方法 IPropertyStore::Commit 會傳回下列任一項:

傳回碼 描述
S_OK
所有屬性變更都已成功寫入資料流程或路徑。 這包括呼叫 方法且未寫入任何變更的情況。
STG_E_ACCESSDENIED
資料流程或檔案是唯讀的;方法無法設定值。
E_FAIL
部分或所有變更都無法寫入檔案。 另一個更說明的錯誤可用來取代E_FAIL。

備註

Commit 方法傳回之前,它會釋放方法所初始化為使用的檔案資料流程或路徑。 因此,傳回之後 Commit ,沒有任何IPropertyStore方法成功。 此時,它們會傳回E_FAIL。

屬性處理常式必須確保屬性變更會導致有效的目的地檔案,即使 Commit 進程異常終止,或遇到任何錯誤也一樣。

需求

   
最低支援的用戶端 適用于 Windows Vista 和更新版本的 Windows 作業系統。
目標平台 Universal
標頭 propsys.h
程式庫 Propsys.idl
IRQL 所有層級

另請參閱

IPropertyStore