RESTOREPOINTINFOA-Struktur (srrestoreptapi.h)

Artikel
11/20/2024

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-

Freigeben über