Wywoływanie programu SRSetRestorePoint

Aplikacja może utworzyć punkt przywracania, zanim spowoduje znaczącą zmianę systemu, taką jak instalacja, odinstalowanie lub aktualizacja.

Instalatory powinny utworzyć punkt przywracania przed instalacją, wywołując funkcję SRSetRestorePoint z elementem członkowskim dwEventType struktury RESTOREPOINTINFO ustawionym na BEGIN_SYSTEM_CHANGE. Aby powiadomić przywracanie systemu o zakończeniu instalacji, wywołaj SRSetRestorePoint z dwEventType ustawionym na END_SYSTEM_CHANGE.

Jeśli użytkownik anuluje instalację aplikacji, instalator może usunąć punkt przywracania utworzony po rozpoczęciu instalacji. Usunięcie punktu przywracania jest opcjonalne i może uniemożliwić użytkownikowi odzyskanie niezamierzonych zmian wprowadzonych przez instalatora podczas anulowania. Jeśli instalator ma usunąć punkt przywracania, może wywołać funkcję SRRemoveRestorePoint lub wywołać SRSetRestorePoint z dwRestorePointType ustawioną na CANCELLED_OPERATION, dwEventType ustawioną na END_SYSTEM_CHANGEi llSequenceNumber ustawioną na wartość zwróconą przez początkowe wywołanie SRSetRestorePoint.

Począwszy od systemu Windows 8 deweloperzy mogą pisać aplikacje, które tworzą wartość DWORD SystemRestorePointCreationFrequency w kluczu rejestru HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore. Wartość tego klucza rejestru może zmienić częstotliwość tworzenia punktu przywracania. Domyślnie ten klucz nie istnieje.

Gdy aplikacja wywołuje funkcję SRSetRestorePoint w celu utworzenia punktu przywracania, jedna z następujących czynności występuje w zależności od zawartości klucza:

• Jeśli klucz nie istnieje (wartość domyślna) i wszystkie punkty przywracania zostały utworzone w ciągu ostatnich 24 godzin, system Windows pomija tworzenie tego nowego punktu przywracania. Przywracanie systemu ustawia członka IISequenceNumber struktury STATEMGRSTATUS na numer sekwencji dla punktu przywracania utworzonego wcześniej w ciągu dnia oraz ustawia wartość członka nStatus na ERROR_SUCCESS. Funkcja SRSetRestorePoint zwraca TRUE.

• Jeśli wartość klucza rejestru wynosi 0, przywracanie systemu nie pomija tworzenia nowego punktu przywracania.

• Jeśli wartość klucza rejestru jest liczbą całkowitą N, przywracanie systemu pomija tworzenie nowego punktu przywracania, jeśli jakiekolwiek punkty przywracania zostały utworzone w ciągu poprzednich N minut.

Przywracanie systemu uruchomione w systemie Windows 8 monitoruje pliki na woluminie rozruchowym, które są istotne tylko dla przywracania systemu. Migawki woluminu rozruchowego utworzonego przez przywracanie systemu uruchomione w systemie Windows 8 mogą zostać usunięte, jeśli migawka zostanie następnie uwidoczniona przez starszą wersję systemu Windows. Należy pamiętać, że chociaż istnieje tylko jeden wolumin systemowy, istnieje jeden wolumin rozruchowy dla każdego systemu operacyjnego w systemie wielo rozruchowym.

Deweloperzy mogą pisać aplikacje, które tworzą wartość DWORD ScopeSnapshots w kluczu rejestru HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore. Jeśli ta wartość klucza rejestru to 0, funkcja Przywracania systemu tworzy migawki woluminu rozruchowego w taki sam sposób jak we wcześniejszych wersjach systemu Windows. Jeśli ta wartość zostanie usunięta, przywracanie systemu uruchomione w systemie Windows 8 wznowi tworzenie migawek monitorujących pliki w woluminie rozruchowym, które są istotne tylko dla przywracania systemu.

Aby zapoznać się z przykładem, zobacz Using System Restore.