IPropertyStore::Commit-Methode (propsys.h)

  • Artikel

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
S_OK
 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.
STG_E_ACCESSDENIED
 Der Stream oder die Datei ist schreibgeschützt. Die -Methode konnte den Wert nicht festlegen.
E_FAIL
 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

Weitere Informationen

Ipropertystore