IPropertyStore::Commit method (propsys.h)
After a change has been made, this method saves the changes.
IPropertyStore::Commit method returns any one of the following:
|All of the property changes were successfully written to the stream or path. This includes the case where no changes were pending when the method was called and nothing was written.
|The stream or file is read-only; the method was not able to set the value.
|Some or all of the changes could not be written to the file. Another, more explanatory error can be used in place of E_FAIL.
Commit method returns, it releases the file stream or path that was initialized to be used by the method. Therefore, no IPropertyStore methods succeed after
Commit returns. At that point, they return E_FAIL.
Property handlers must ensure that property changes result in a valid destination file, even if the
Commit process terminates abnormally, or encounters any errors.
|Minimum supported client
|Available with Windows Vista and later versions of the Windows operating system.