Funzione SisCreateBackupStructure
La funzione SisCreateBackupStructure crea una struttura di backup SIS basata sulle informazioni fornite.
Sintassi
BOOL SisCreateBackupStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisBackupStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Parametri
-
volumeRoot [in]
-
Nome file della radice del volume, senza la barra rovesciata finale, del volume di cui eseguire il backup. Ad esempio, specificare "C:" e non "C:\".
-
sisBackupStructure [out]
-
Struttura di backup SIS restituita.
-
commonStoreRootPathname [out]
-
Nome percorso completo dell'archivio comune del volume specificato. Ad esempio, "c:\SIS Common Store".
-
countOfCommonStoreFilesToBackUp [out]
-
Numero di file elencati nel parametro commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Puntatore a una matrice di nomi di file che specifica un elenco di file interni utilizzati da SIS per gestire il volume specificato. Questi file devono essere sottoposti a backup contemporaneamente e allo stesso modo dei file di archivio comuni richiesti da SisCSFilesToBackupForLink
Valore restituito
Questa funzione restituisce TRUE se viene completata correttamente e FALSE in caso contrario. Chiamare GetLastError per ottenere altre informazioni sul motivo per cui la chiamata non è riuscita.
Commenti
Questa funzione crea una struttura di backup SIS, usata dall'API di backup SIS per creare e gestire un elenco dei collegamenti di file nel volume e i file originali a cui puntano i collegamenti. Questa funzione deve essere chiamata una sola volta per ogni volume abilitato per SIS di cui viene eseguito il backup. Tutti i file all'interno del volume specificato devono essere considerati come file di archivio comune e sottoposti a backup solo se SIS indica che devono essere usati.
I parametri countOfCommonStoreFilesToBackUp e commonStoreFilesToBackUp restituiscono insieme un elenco di file di cui è necessario eseguire il backup indipendentemente dai collegamenti di cui viene eseguito il backup.
Se countOfCommonStoreFilesToBackUp è 0, commonStoreFilesToBackUp può essere un puntatore NULL . Il valore del parametro commonStoreFilesToBackUp deve essere ignorato.
Al termine dell'operazione di backup, deallocare la memoria usata dalla matrice commonStoreFilesToBackUp di stringhe chiamando SisFreeAllocatedMemory.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|