Freigeben über

RESTOREPOINTINFOA-Struktur (srrestoreptapi.h)

Enthält Informationen, die von der SRSetRestorePoint--Funktion verwendet werden.

Syntax

typedef struct _RESTOREPTINFOA {
  DWORD dwEventType;
  DWORD dwRestorePtType;
  INT64 llSequenceNumber;
  CHAR  szDescription[MAX_DESC];
} RESTOREPOINTINFOA, *PRESTOREPOINTINFOA;

Angehörige

dwEventType

Der Ereignistyp. Dieses Element kann einer der folgenden Werte sein:

Ereignistyp Bedeutung
BEGIN_NESTED_SYSTEM_CHANGE
102
 Eine Systemänderung hat begonnen. Bei einem nachfolgenden geschachtelten Aufruf wird kein neuer Wiederherstellungspunkt erstellt.

Nachfolgende Aufrufe müssen END_NESTED_SYSTEM_CHANGE und nicht END_SYSTEM_CHANGE verwenden.
BEGIN_SYSTEM_CHANGE
100
 Eine Systemänderung hat begonnen.
END_NESTED_SYSTEM_CHANGE
103
 Eine Systemänderung wurde beendet.
END_SYSTEM_CHANGE
101
 Eine Systemänderung wurde beendet.

dwRestorePtType

Der Typ des Wiederherstellungspunkts. Dieses Element kann einer der folgenden Werte sein:

Wiederherstellungspunkttyp Bedeutung
APPLICATION_INSTALL
0
 Eine Anwendung wurde installiert.
APPLICATION_UNINSTALL
1
 Eine Anwendung wurde deinstalliert.
DEVICE_DRIVER_INSTALL
10
 Ein Gerätetreiber wurde installiert.
MODIFY_SETTINGS
12
 Eine Anwendung hat Features hinzugefügt oder entfernt.
CANCELLED_OPERATION
13
 Eine Anwendung muss den erstellten Wiederherstellungspunkt löschen. Beispielsweise würde eine Anwendung dieses Kennzeichen verwenden, wenn ein Benutzer eine Installation abbricht.

llSequenceNumber

Die Sequenznummer des Wiederherstellungspunkts. Um eine Systemänderung zu beenden, legen Sie dies auf die Sequenznummer fest, die vom vorherigen Aufruf an SRSetRestorePointzurückgegeben wird.

szDescription[MAX_DESC]

Die beschreibung, die angezeigt werden soll, damit der Benutzer einen Wiederherstellungspunkt leicht identifizieren kann. Die maximale Länge einer ANSI-Zeichenfolge ist MAX_DESC. Die maximale Länge einer Unicode-Zeichenfolge ist MAX_DESC_W. Weitere Informationen finden Sie unter Wiederherstellen von Punktbeschreibungstext.

Bemerkungen

Anmerkung

Der srrestoreptapi.h-Header definiert RESTOREPOINTINFO als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP [nur Desktop-Apps]
mindestens unterstützte Server- Keine unterstützt
Header- srrestoreptapi.h

Siehe auch

SRSetRestorePoint-