Método IPropertyStore::Commit (propsys.h)

  • Artículo

Una vez realizado un cambio, este método guarda los cambios.

Sintaxis

HRESULT Commit();

Valor devuelto

El IPropertyStore::Commit método devuelve una de las siguientes opciones:

Código devuelto Descripción
S_OK
 Todos los cambios de propiedad se escribieron correctamente en la secuencia o ruta de acceso. Esto incluye el caso en el que no había cambios pendientes cuando se llamó al método y no se escribió nada.
STG_E_ACCESSDENIED
 La secuencia o el archivo son de solo lectura; el método no pudo establecer el valor.
E_FAIL
 Algunos o todos los cambios no se pudieron escribir en el archivo. Otro error más explicativo se puede usar en lugar de E_FAIL.

Comentarios

Antes de que el Commit método devuelva, libera la secuencia de archivos o la ruta de acceso inicializada que el método ha inicializado. Por lo tanto, ningún método IPropertyStore se realiza correctamente después Commit de las devoluciones. En ese momento, devuelven E_FAIL.

Los controladores de propiedades deben asegurarse de que los cambios de propiedad dan lugar a un archivo de destino válido, incluso si el Commit proceso finaliza de forma anómala o encuentra errores.

Requisitos

   
Cliente mínimo compatible Disponible con Windows Vista y versiones posteriores del sistema operativo Windows.
Plataforma de destino Universal
Encabezado propsys.h
Library Propsys.idl
IRQL Todos los niveles

Consulte también

IPropertyStore