SisRestoredLink-Funktion

Die SisRestoredLink-Funktion gibt die Namen der Common-Store-Datei oder dateien zurück, auf die vom angegebenen wiederhergestellten SIS-Link verwiesen wird.

Syntax

BOOL SisRestoredLink(
  _In_  PVOID  sisRestoreStructure,
  _In_  PWCHAR restoredFileName,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PULONG countOfCommonStoreFilesToRestore,
  _Out_ PWCHAR **commonStoreFilesToRestore
);

Parameter

sisRestoreStructure [in]

Zeiger auf eine SIS-Wiederherstellungsstruktur, die von SisCreateRestoreStructure zurückgegeben wird.

restoredFileName [in]

Vollqualifizierter Dateiname der wiederhergestellten SIS-Linkdatei.

reparseData [in]

Zeiger auf den Inhalt des SIS-Analysepunkts. Dieser Analysepunkt enthält Daten, die den wiederhergestellten SIS-Link beschreiben. Um die Analysepunktdaten für eine Datei abzurufen, verwenden Sie den FSCTL_GET_REPARSE_POINT-Steuerelementcode .

reparseDataSize [in]

Größe des Inhalts des SIS-Analysepunkts, auf den von reparseData verwiesen wird, in Bytes.

countOfCommonStoreFilesToRestore [out]

Anzahl der dateien, die im commonStoreFilesToRestore-Parameter aufgeführt sind.

commonStoreFilesToRestore [out]

Zeiger auf ein Array von Common-Store-Dateinamen. Diese Dateien sollten gleichzeitig und auf die gleiche Weise wie die common-store-Dateien wiederhergestellt werden, die von SisCSFilesToBackupForLink angefordert werden.

Wenn der Wert des parameters countOfCommonStoreFilesToRestore nicht 0 ist, enthält der Wert des commonStoreFilesToRestore-Parameters die Namen der Common-Store-Dateien, die infolge der Wiederherstellung des SIS-Links wiederhergestellt werden sollen. Wenn der Wert 0 ist, wurden entweder die Common-Store-Dateien einmal zurückgegeben, oder sie sind bereits auf dem Volume vorhanden.

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

Sie sollten diese Funktion für jeden wiederhergestellten SIS-Link aufrufen.

Diese Funktion gibt jede Common-Store-Datei für jeden Wiederherstellungsvorgang höchstens einmal zurück. Jeder Versuch, zusätzliche SIS-Links wiederherzustellen, bei denen dieselbe Common-Store-Datei angezeigt wird, führt nicht dazu, dass dieser Common-Store-Dateiname zurückgegeben wird.

Diese Funktion gibt keine Common-Store-Datei zurück, die nicht auch in einem Aufruf von SisCSFilesToBackupForLink während des Sicherungsvorgangs zurückgegeben wurde, vorausgesetzt, dass die auf dem Medium gespeicherten SIS-Reparsedaten nicht beschädigt wurden.

Beim Wiederherstellen eines SIS-Links sollte Ihr Wiederherstellungsvorgang nur die entsprechende Sparsedatei erstellen, alle zugeordneten Bereiche initialisieren und dann die SIS-Analysedaten genau so schreiben, wie sie während des Sicherungsvorgangs gelesen wurden. Es ist wichtig, dass Ihr Wiederherstellungsvorgang Sparsedateien mit nicht zugeordneten Bereichen anstelle von Sparsedateien (oder Nichtsparsedateien) erstellt, die mit Nullen initialisiert werden.

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 Common-Store-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 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.

Anforderungen

Siehe auch

SisCreateRestoreStructure

SisCSFilesToBackupForLink