IPropertyStore::Commit-Methode (propsys.h)
Nachdem eine Änderung vorgenommen wurde, speichert diese Methode die Änderungen.
Syntax
HRESULT Commit();
Rückgabewert
Die IPropertyStore::Commit -Methode gibt eine der folgenden Elemente zurück:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Alle Eigenschaftenänderungen wurden erfolgreich in den Stream oder Pfad geschrieben. Dies schließt den Fall ein, in dem beim Aufruf der Methode keine Änderungen ausstehen und nichts geschrieben wurde. |
|
Der Stream oder die Datei ist schreibgeschützt. Die -Methode konnte den Wert nicht festlegen. |
|
Einige oder alle Änderungen konnten nicht in die Datei geschrieben werden. Ein weiterer, erklärender Fehler kann anstelle von E_FAIL verwendet werden. |
Hinweise
Bevor die Commit Methode zurückgibt, gibt sie den Dateistream oder Pfad frei, der für die Verwendung von der -Methode initialisiert wurde. Daher sind nach Commit der Rückgabe keine IPropertyStore-Methoden erfolgreich. An diesem Punkt geben sie E_FAIL zurück.
Eigenschaftenhandler müssen sicherstellen, dass Eigenschaftenänderungen zu einer gültigen Zieldatei führen, auch wenn der Commit Prozess abnormal beendet wird oder Fehler auftreten.
Anforderungen
| Unterstützte Mindestversion (Client) | Verfügbar mit Windows Vista und höheren Versionen des Windows-Betriebssystems. |
| Zielplattform | Universell |
| Header | propsys.h |
| Bibliothek | Propsys.idl |
| IRQL | Alle Ebenen |