SisCreateRestoreStructure-Funktion
Die SisCreateRestoreStructure-Funktion erstellt eine SIS-Wiederherstellungsstruktur basierend auf den bereitgestellten Informationen.
Syntax
BOOL SisCreateRestoreStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisRestoreStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
Parameter
-
volumeRoot [in]
-
Dateiname des Volumestamms ohne den nachfolgenden umgekehrten Schrägstrich des zu sichernden Volumes. Geben Sie beispielsweise "C:" und nicht "C:\" an. Das Volume darf nicht das System- oder Startvolume sein.
-
sisRestoreStructure [out]
-
Zurückgegebene SIS-Wiederherstellungsstruktur. Diese Struktur sollte vom Aufrufer als undurchsichtig behandelt werden.
-
commonStoreRootPathname [out]
-
Vollqualifizierter Pfadname des allgemeinen Speichers des angegebenen Volumes. Beispiel: "c:\SIS Common Store".
-
countOfCommonStoreFilesToRestore [out]
-
Anzahl der dateien, die im commonStoreFilesToRestore-Parameter aufgeführt sind.
-
commonStoreFilesToRestore [out]
-
Zeiger auf ein Array von Dateinamen, das die Liste der internen Dateien angibt, die vom SIS zum Verwalten des angegebenen Volumes verwendet werden. Diese Dateien sollten gleichzeitig und auf die gleiche Weise wie die common-store-Dateien wiederhergestellt werden, die von SisCSFilesToBackupForLink angefordert werden.
Rückgabewert
Diese Funktion gibt TRUE zurück, wenn sie erfolgreich abgeschlossen wird, andernfalls FALSE . Rufen Sie GetLastError auf, um weitere Informationen zum Grund zu erhalten, warum der Anruf fehlgeschlagen ist.
Bemerkungen
Diese Funktion richtet die Wiederherstellungsumgebung auf dem angegebenen Volume so ein, wie SisCreateBackupStructure die Sicherungsumgebung auf dem angegebenen Volume erstellt.
Beachten Sie, dass diese Funktion nicht unbedingt die Common-Store-Datei oder Dateien identifiziert, die einer Reihe von SIS-Links auf den Sicherungsmedien entsprechen, wenn diese gemeinsamen Speicherdateien oder -dateien noch auf dem Datenträger vorhanden sind. Der Inhalt des Datenstroms einer Common-Store-Datei ändert sich nach der Erstellung nie. Wenn die Datei bereits auf dem Datenträger vorhanden ist, muss sie also nicht wiederhergestellt werden.
Common-Store-Dateinamen sind global eindeutig, um die Integrität des Wiederherstellungsvorgangs sicherzustellen, auch wenn er nicht auf demselben SIS-aktivierten Volume auftritt, auf das der Sicherungsvorgang zugegriffen hat.
Nachdem der Wiederherstellungsvorgang abgeschlossen ist, können Sie den vom commonStoreFilesToRestore-Array von Zeichenfolgen verwendeten Arbeitsspeicher sortieren, indem Sie SisFreeAllocatedMemory aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|