SisCreateBackupStructure-Funktion
Die SisCreateBackupStructure-Funktion erstellt eine SIS-Sicherungsstruktur basierend auf den bereitgestellten Informationen.
Syntax
BOOL SisCreateBackupStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisBackupStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Parameter
-
volumeRoot [ In]
-
Dateiname des Volumestamms ohne den nachgestellten umgekehrten Schrägstrich des zu sichernden Volumes. Geben Sie beispielsweise "C:" und nicht "C: \ " an.
-
sisBackupStructure [ out]
-
Die SIS-Sicherungsstruktur wurde zurückgegeben.
-
commonStoreRootPathname [ out]
-
Vollqualifizierte Pfadname des allgemeinen Speichers des angegebenen Volumes. Beispiel: "c: \ SIS Common Store".
-
countOfCommonStoreFilesToBackUp [ out]
-
Anzahl der Dateien, die im commonStoreFilesToBackUp-Parameter aufgeführt sind.
-
commonStoreFilesToBackUp [ out]
-
Zeiger auf ein Array von Dateinamen, das eine Liste interner Dateien angibt, die von SIS zum Verwalten des angegebenen Volumes verwendet werden. Diese Dateien sollten gleichzeitig und auf die gleiche Weise gesichert werden wie die allgemeinen Speicherdateien, die von SisCSFilesToBackupForLink angefordert werden.
Rückgabewert
Diese Funktion gibt TRUE zurück, wenn sie erfolgreich abgeschlossen wurde, andernfalls FALSE. Rufen Sie GetLastError auf, um weitere Informationen zur Ursache des Fehlers beim Aufruf zu erhalten.
Hinweise
Diese Funktion erstellt eine SIS-Sicherungsstruktur, die von der SIS-Sicherungs-API verwendet wird, um eine Liste der Dateilinks auf dem Volume und der ursprünglichen Dateien zu erstellen und zu verwalten, auf die die Links verweisen. Diese Funktion sollte nur einmal für jedes zu sichernde SIS-fähige Volume aufgerufen werden. Alle Dateien auf dem angegebenen Volume sollten nur dann als Gemeinsame Speicherdateien behandelt und gesichert werden, wenn SIS dies angibt.
Die Parameter countOfCommonStoreFilesToBackUp und commonStoreFilesToBackUp geben zusammen eine Liste von Dateien zurück, die unabhängig davon gesichert werden müssen, welche Links gesichert werden.
Wenn countOfCommonStoreFilesToBackUp 0 ist, kann commonStoreFilesToBackUp ein NULL-Zeiger sein. Der Wert des commonStoreFilesToBackUp-Parameters sollte ignoriert werden.
Nachdem der Sicherungsvorgang abgeschlossen ist, können Sie die Zuordnung des vom commonStoreFilesToBackUp-Array von Zeichenfolgen verwendeten Arbeitsspeichers durch Aufrufen von SisFreeAllocatedMemory wieder wiederherstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|