Función SisCreateBackupStructure
La función SisCreateBackupStructure crea una estructura de copia de seguridad de SIS basada en la información proporcionada.
Sintaxis
BOOL SisCreateBackupStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisBackupStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Parámetros
-
volumeRoot [in]
-
Nombre de archivo de la raíz del volumen, sin la barra diagonal inversa final, del volumen del que se va a realizar una copia de seguridad. Por ejemplo, especifique "C:" y no "C:\".
-
sisBackupStructure [out]
-
Estructura de copia de seguridad de SIS devuelta.
-
commonStoreRootPathname [out]
-
Nombre completo de la ruta de acceso del almacén común del volumen especificado. Por ejemplo, "c:\SIS Common Store".
-
countOfCommonStoreFilesToBackUp [out]
-
Número de archivos enumerados en el parámetro commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Puntero a una matriz de nombres de archivo que especifica una lista de archivos internos usados por SIS para administrar el volumen especificado. Estos archivos se deben realizar copias de seguridad al mismo tiempo y de la misma manera que los archivos de almacén común solicitados por SisCSFilesToBackupForLink
Valor devuelto
Esta función devuelve TRUE si se completa correctamente y FALSE en caso contrario. Llame a GetLastError para obtener más información sobre el motivo por el que se produjo un error en la llamada.
Comentarios
Esta función crea una estructura de copia de seguridad de SIS, que la API de copia de seguridad de SIS usa para crear y mantener una lista de los vínculos de archivo en el volumen y los archivos originales a los que apuntan los vínculos. Se debe llamar a esta función solo una vez para cada volumen habilitado para SIS del que se realiza una copia de seguridad. Todos los archivos del volumen especificado deben tratarse como archivos de almacén común y se deben realizar copias de seguridad solo si SIS indica que deben.
Los parámetros countOfCommonStoreFilesToBackUp y commonStoreFilesToBackUp devuelven juntos una lista de archivos de los que se debe realizar una copia de seguridad, independientemente de los vínculos de los que se haga una copia de seguridad.
Si countOfCommonStoreFilesToBackUp es 0, commonStoreFilesToBackUp puede ser un puntero NULL . Se debe omitir el valor del parámetro commonStoreFilesToBackUp .
Una vez completada la operación de copia de seguridad, desasigne la memoria usada por la matriz commonStoreFilesToBackUp de cadenas mediante una llamada a SisFreeAllocatedMemory.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|