IPropertyStore::Commit, méthode (propsys.h)
Une fois qu’une modification a été apportée, cette méthode enregistre les modifications.
Syntaxe
HRESULT Commit();
Valeur de retour
La IPropertyStore::Commit méthode retourne l’un des éléments suivants :
| Code de retour | Description |
|---|---|
|
Toutes les modifications de propriété ont été correctement écrites dans le flux ou le chemin d’accès. Cela inclut le cas où aucune modification n’était en attente lorsque la méthode a été appelée et que rien n’a été écrit. |
|
Le flux ou le fichier est en lecture seule ; la méthode n’a pas pu définir la valeur. |
|
Certaines ou toutes les modifications n’ont pas pu être écrites dans le fichier. Une autre erreur plus explicite peut être utilisée à la place de E_FAIL. |
Notes
Avant que la Commit méthode ne retourne, elle libère le flux de fichiers ou le chemin d’accès qui a été initialisé pour être utilisé par la méthode. Par conséquent, aucune méthode IPropertyStore ne réussit après Commit les retours. À ce stade, ils retournent E_FAIL.
Les gestionnaires de propriétés doivent s’assurer que les modifications de propriété aboutissent à un fichier de destination valide, même si le Commit processus se termine anormalement ou rencontre des erreurs.
Spécifications
| Client minimal pris en charge | Disponible avec Windows Vista et les versions ultérieures du système d’exploitation Windows. |
| Plateforme cible | Universal |
| En-tête | propsys.h |
| Bibliothèque | Propsys.idl |
| IRQL | Tous les niveaux |