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 nachfolgenden 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]
-
Vollqualifizierter Pfadname des allgemeinen Speichers des angegebenen Volumes. Beispiel: "c:\SIS Common Store".
-
countOfCommonStoreFilesToBackUp [out]
-
Anzahl der dateien, die im parameter commonStoreFilesToBackUp aufgeführt sind.
-
commonStoreFilesToBackUp [out]
-
Zeiger auf ein Array von Dateinamen, das eine 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 von SisCSFilesToBackupForLink angeforderten Common-Store-Dateien gesichert 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 Aufruf fehlgeschlagen ist.
Bemerkungen
Diese Funktion erstellt eine SIS-Sicherungsstruktur, die von der SIS-Sicherungs-API verwendet wird, um eine Liste der Dateilinks auf dem Volume und den 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 innerhalb des angegebenen Volumes sollten nur dann als Common-Store-Dateien behandelt und gesichert werden, wenn SIS angibt, dass dies erforderlich ist.
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 den Wert 0 aufweist, kann commonStoreFilesToBackUp ein NULL-Zeiger sein. Der Wert des parameters commonStoreFilesToBackUp sollte ignoriert werden.
Nachdem der Sicherungsvorgang abgeschlossen ist, heben Sie die Zuordnung des arbeitsspeichers, der vom commonStoreFilesToBackUp-Array von Zeichenfolgen verwendet wird, auf, 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 |
|