IFileSystemImage::get_ChangePoint-Methode (imapi2fs.h)

Ruft den Änderungspunktbezeichner ab.

Syntax

HRESULT get_ChangePoint(
  [out] LONG *pVal
);

Parameter

[out] pVal

Änderungspunktbezeichner. Der Bezeichner ist die Anzahl der Änderungen am Dateisystemimage seit seiner Einführung.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_POINTER
Der Zeiger ist ungültig.

Wert: 0x80004003

Hinweise

Eine Anwendung kann den Wert dieser Eigenschaft speichern, bevor sie eine Änderung am Dateisystem vornimmt, und zu einem späteren Zeitpunkt den Wert an die IFileSystemImage::RollbackToChangePoint-Methode übergeben, um änderungen seit diesem Zeitpunkt in der Entwicklung zu rückgängig machen.

Eine Anwendung kann die IFileSystemImage::LockInChangePoint-Methode aufrufen, um den Zustand eines Dateisystemimages zu jedem Zeitpunkt der Entwicklung zu sperren. Sobald eine Sperre festgelegt wurde, können Sie RollbackToChangePoint nicht mehr aufrufen, um das Dateisystemimage in den früheren Zustand zu rückgängig machen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile imapi2fs.h

Weitere Informationen

IFileSystemImage

IFileSystemImage::LockInChangePoint

IFileSystemImage::RollbackToChangePoint