SisCSFilesToBackupForLink-Funktion

Die SisCSFilesToBackupForLink-Funktion gibt Informationen zurück, die die Common-Store-Dateien beschreiben, auf die der angegebene SIS-Link verweist.

Syntax

BOOL SisCSFilesToBackupForLink(
  _In_  PVOID  sisBackupStructure,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PVOID  thisFileContext,
  _Out_ PVOID  *matchingFileContext,
  _Out_ PULONG countOfCommonStoreFilesToBackUp,
  _Out_ PWCHAR **commonStoreFilesToBackUp
);

Parameter

sisBackupStructure [in]

Zeiger auf die SIS-Sicherungsstruktur, die von SisCreateBackupStructure zurückgegeben wird.

reparseData [in]

Zeiger auf den Inhalt des SIS-Analysepunkts. Dieser Analysepunkt enthält Daten, die eine SIS-Verknüpfung 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 in Bytes verwiesen wird.

thisFileContext [out]

Zeiger auf eine Kontextzeichenfolge, die von der Sicherungsanwendung bereitgestellt wird, die diese Funktion aufruft. Der Inhalt dieser Inhaltszeichenfolge wird vollständig von dieser Sicherungsanwendung bestimmt und nicht von der SIS Backup-API interpretiert. Dieser Parameter ist optional. Wenn sie nicht verwendet wird, legen Sie den Wert dieses Parameters auf NULL fest. Der Wert dieses Parameters wird in diesem Fall nicht verarbeitet.

matchingFileContext [out]

Doppelt indirekter Zeiger auf die Kontextzeichenfolge der SIS-Verknüpfung, die durch die In den ersten vier Parametern dieser Funktion übergebenen Informationen identifiziert wird. Dieser Parameter ist optional. Wenn keine Kontextzeichenfolge als Wert des parameters thisFileContext angegeben wird, legen Sie den Wert dieses Parameters auf NULL fest. Der Wert dieses Parameters wird in diesem Fall nicht verarbeitet.

countOfCommonStoreFilesToBackUp [out]

Anzahl der dateien, die im parameter commonStoreFilesToBackUp aufgeführt sind.

commonStoreFilesToBackUp [out]

Zeiger auf ein Array von Dateinamen. Diese Dateien sollten gleichzeitig und auf die gleiche Weise wie die von SisCreateBackupStructure 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

Die Sicherungsanwendung sollte diese Funktion nur einmal für jede zu sichernde SIS-Linkdatei aufrufen.

Die Sicherungsanwendung kann einen SIS-Analysepunkt anhand seines Tags identifizieren, IO_REPARSE_TAG_SIS. Dieses Tag ist in Winnt.h definiert.

Wenn dieser Analysepunkt, der durch den Wert des reparseData-Parameters identifiziert wird, die erste instance einer zu sichernden Datei beschreibt, gibt diese Funktion NULL als Wert des matchingFileContext-Parameters zurück und initialisiert den Wert des commonStoreFilesToBackUp-Arrays von Zeichenfolgen mit den Namen der zu sichernden Common-Store-Datei oder der zu sichernden Dateien. Andernfalls legt diese Funktion den Wert des matchingFileContext-Parameters auf die Kontextzeichenfolge fest, die dem ersten instance der angegebenen Datei entspricht, und legt den Wert des parameters countOfCommonStoreFilesToBackUp auf 0 fest. Wenn mehrere Common-Store-Dateien vorhanden sind, die dem angegebenen Link entsprechen, entspricht der Wert des parameters thisFileContext der Kontextzeichenfolge, die der ersten common-store-Datei entspricht, die im Array zurückgegeben wird, nämlich commonStoreFilesToBackUp[0].

Die aktuelle Version dieser Funktion gibt höchstens eine Common-Store-Datei zurück, aber es ist möglich, dass in zukünftigen Versionen ein einzelner Link von mehreren common-store-Dateien unterstützt wird, z. B. eine für jeden Stream in der Datei, sodass Ihre Sicherungsanwendung bei jedem Aufruf dieser Funktion mehrere Dateien unterstützen sollte. In jedem Fall wird jede Common-Store-Datei höchstens einmal für jeden Sicherungsdurchlauf zurückgegeben.

Ihre Sicherungsanwendung sollte die Common-Store-Datei(n) sichern oder wiederherstellen, die durch den im commonStoreFilesToBackUp-Parameter zurückgegebenen Dateinamen oder Dateinamen identifiziert werden. Unabhängig davon, ob eine entsprechende Common-Store-Datei vorhanden ist, sollte Ihre Sicherungsanwendung die SIS-Linkdatei so sichern, wie sie auf dem Datenträger vorhanden ist, z. B. als Analysepunkt und als Sparsedatei, und höchstwahrscheinlich ohne ausgefüllte Bereiche. Ihre Sicherungsanwendung kann die Common-Store-Datei oder -Dateien sofort sichern oder wiederherstellen, sie aufschieben oder bei Bedarf kombinieren.

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

Siehe auch

SisFreeAllocatedMemory

SisCreateBackupStructure