Funzione SisRestoredLink
La funzione SisRestoredLink restituisce i nomi del file o dei file dell'archivio comune a cui punta il collegamento SIS ripristinato specificato.
Sintassi
BOOL SisRestoredLink(
_In_ PVOID sisRestoreStructure,
_In_ PWCHAR restoredFileName,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
Parametri
-
sisRestoreStructure [in]
-
Puntatore a una struttura di ripristino SIS restituita da SisCreateRestoreStructure.
-
restoredFileName [in]
-
Nome file completo del file di collegamento SIS ripristinato.
-
reparseData [in]
-
Puntatore al contenuto del reparse point SIS. Questo reparse point contiene dati che descrivono il collegamento SIS ripristinato. Per recuperare i dati dei reparse point per un file, usare il codice di controllo FSCTL_GET_REPARSE_POINT .
-
reparseDataSize [in]
-
Dimensioni del contenuto del punto di ripristino SIS a cui punta reparseData, in byte.
-
countOfCommonStoreFilesToRestore [out]
-
Numero di file elencati nel parametro commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Puntatore a una matrice di nomi di file di archivio comuni. Questi file devono essere ripristinati contemporaneamente e nello stesso modo dei file di archivio comuni richiesti da SisCSFilesToBackupForLink.
Se il valore del parametro countOfCommonStoreFilesToRestore non è 0, il valore del parametro commonStoreFilesToRestore conterrà i nomi dei file dell'archivio comune da ripristinare in seguito al ripristino del collegamento SIS. Se il valore è 0, i file dell'archivio comune sono stati restituiti una sola volta o sono già presenti nel volume.
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
È consigliabile chiamare questa funzione per ogni collegamento SIS ripristinato.
Questa funzione restituirà ogni file di archivio comune al massimo una volta per ogni operazione di ripristino; qualsiasi tentativo di ripristinare collegamenti SIS aggiuntivi che visualizzano lo stesso file dell'archivio comune non comporterà la restituzione del nome file dell'archivio comune.
Questa funzione non restituirà un file di archivio comune che non è stato restituito anche in una chiamata a SisCSFilesToBackupForLink durante l'operazione di backup, presupponendo che i dati SIS archiviati nel supporto non siano stati danneggiati.
Durante il ripristino di un collegamento SIS, l'operazione di ripristino deve creare solo il file sparse appropriato, inizializzare tutti gli intervalli allocati e quindi scrivere i dati di cui si esegue la ricerca esattamente come sono stati letti durante l'operazione di backup. È fondamentale che l'operazione di ripristino crei file sparse con intervalli non allocati anziché file sparse (o file nonsparse) inizializzati con zeri.
Si noti che questa funzione non identificherà necessariamente il file o i file dell'archivio comune corrispondenti a un set di collegamenti SIS nel supporto di backup se tali file o file di archivio comune 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à sul disco non è necessario ripristinarlo.
I nomi di 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|