Funzione SisCreateRestoreStructure
La funzione SisCreateRestoreStructure crea una struttura di ripristino SIS basata sulle informazioni fornite.
Sintassi
BOOL SisCreateRestoreStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisRestoreStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
Parametri
-
volumeRoot [in]
-
Nome file della radice del volume, senza la barra rovesciata finale, del volume da eseguire il backup. Ad esempio, specificare "C:" e non "C:\". Il volume non può essere il volume di sistema o di avvio.
-
sisRestoreStructure [out]
-
Struttura di ripristino SIS restituita. Questa struttura deve essere considerata opaca dal chiamante.
-
commonStoreRootPathname [out]
-
Nome percorso completo dell'archivio comune del volume specificato. Ad esempio, "c:\SIS Common Store".
-
countOfCommonStoreFilesToRestore [out]
-
Numero di file elencati nel parametro commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Puntatore a una matrice di nomi di file che specifica l'elenco di file interni usati da SIS per gestire il volume specificato. Questi file devono essere ripristinati contemporaneamente e nello stesso modo dei file 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 stabilisce l'ambiente di ripristino nel volume specificato nel modo in cui SisCreateBackupStructure stabilisce l'ambiente di backup nel volume specificato.
Si noti che questa funzione non identifica necessariamente il file o i file di archivio comuni corrispondenti a un set di collegamenti SIS nel supporto di backup se tali file o file di archivio comuni esistono ancora su disco. Il contenuto di un flusso di dati di un file di archivio comune non cambia mai una volta creato, quindi se il file esiste già nel disco non è necessario ripristinarlo.
I nomi dei file dell'archivio comune sono univoci a livello globale per garantire l'integrità dell'operazione di ripristino anche se non si verifica nello stesso volume abilitato per SIS a cui ha accesso l'operazione di backup.
Al termine dell'operazione di ripristino, deallocare la memoria usata dalla matrice commonStoreFilesToRestore 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 |
|