IPropertyStore::Commit 方法 (propsys.h)

进行更改后,此方法将保存更改。

语法

HRESULT Commit();

返回值

方法 IPropertyStore::Commit 返回以下任一项:

返回代码 说明
S_OK
所有属性更改都已成功写入流或路径。 这包括调用 方法时没有挂起更改且未写入任何更改的情况。
STG_E_ACCESSDENIED
流或文件为只读;方法无法设置值。
E_FAIL
无法将部分或全部更改写入文件。 另一个解释性更高的错误可用于代替E_FAIL。

注解

Commit 方法返回之前,它会释放已初始化为方法使用的文件流或路径。 因此,返回 后Commit没有 IPropertyStore 方法成功。 此时,它们返回E_FAIL。

属性处理程序必须确保属性更改导致有效的目标文件,即使 Commit 进程异常终止或遇到任何错误。

要求

   
最低受支持的客户端 适用于 Windows Vista 和更高版本的 Windows 操作系统。
目标平台 通用
标头 propsys.h
Library Propsys.idl
IRQL 所有级别

请参阅

IPropertyStore