Funzione SisCSFilesToBackupForLink
La funzione SisCSFilesToBackupForLink restituisce informazioni che descrivono i file dell'archivio comune a cui punta il collegamento SIS specificato.
Sintassi
BOOL SisCSFilesToBackupForLink(
_In_ PVOID sisBackupStructure,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PVOID thisFileContext,
_Out_ PVOID *matchingFileContext,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Parametri
-
sisBackupStructure [in]
-
Puntatore alla struttura di backup SIS restituita da SisCreateBackupStructure.
-
reparseData [in]
-
Puntatore al contenuto del reparse point SIS. Questo reparse point contiene dati che descrivono un collegamento SIS. 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.
-
thisFileContext [out]
-
Puntatore a una stringa di contesto fornita dall'applicazione di backup che chiama questa funzione. Il contenuto di questa stringa di contenuto è interamente determinato da questa applicazione di backup e non viene interpretato dall'API di backup SIS. Questo parametro è facoltativo; se non viene usato, impostare il valore di questo parametro su NULL. Il valore di questo parametro non verrà elaborato in questo caso.
-
matchingFileContext [out]
-
Puntatore doubly-indiretto alla stringa di contesto del collegamento SIS identificato dalle informazioni passate nei primi quattro parametri di questa funzione. Questo parametro è facoltativo; se una stringa di contesto non viene specificata come valore del parametro thisFileContext , impostare il valore di questo parametro su NULL. Il valore di questo parametro non verrà elaborato in questo caso.
-
countOfCommonStoreFilesToBackUp [out]
-
Numero di file elencati nel parametro commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Puntatore a una matrice di nomi di file. Questi file devono essere sottoposti a backup contemporaneamente e allo stesso modo dei file di archivio comuni richiesti da SisCreateBackupStructure.
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
L'applicazione di backup deve chiamare questa funzione una sola volta per ogni file di collegamento SIS di cui viene eseguito il backup.
L'applicazione di backup può identificare un punto di ripristino SIS in base al tag IO_REPARSE_TAG_SIS. Questo tag è definito in Winnt.h.
Se questo reparse point identificato dal valore del parametro reparseData descrive la prima istanza di un file di cui eseguire il backup, questa funzione restituirà NULL come valore del parametro matchingFileContext e inizializzerà il valore della matrice commonStoreFilesToBackUp di stringhe con i nomi del file o dei file dell'archivio comune di cui eseguire il backup. In caso contrario, questa funzione imposterà il valore del parametro matchingFileContext sulla stringa di contesto corrispondente alla prima istanza del file specificato e imposterà il valore del parametro countOfCommonStoreFilesToBackUp su 0. Se sono presenti più file di archivio comuni corrispondenti al collegamento specificato, il valore del parametro thisFileContext sarà la stringa di contesto corrispondente al primo file dell'archivio comune restituito nella matrice, ovvero commonStoreFilesToBackUp[0].
La versione corrente di questa funzione restituirà al massimo un file di archivio comune, ma è possibile che nelle versioni future un singolo collegamento possa essere supportato da diversi file di archivio comune, ad esempio uno per ogni flusso nel file in modo che l'applicazione di backup supporti più file in ogni chiamata a questa funzione. In ogni caso, ogni file dell'archivio comune verrà restituito al massimo una volta per ogni passaggio di backup.
L'applicazione di backup deve eseguire il backup o ripristinare il file o i file dell'archivio comune identificati dal nome file o dai nomi di file restituiti nel parametro commonStoreFilesToBackUp . Indipendentemente dal fatto che sia presente un file di archivio comune corrispondente, l'applicazione di backup deve eseguire il backup del file di collegamento SIS così com'è presente sul disco, ad esempio, come punto di ripristino e un file sparse e, molto probabilmente, senza intervalli compilati. L'applicazione di backup può eseguire immediatamente il backup o il ripristino del file o dei file dell'archivio comune, posticiparne il backup o combinarli in base alle esigenze.
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 |
|