Función SisCreateRestoreStructure
La función SisCreateRestoreStructure crea una estructura de restauración siS basada en la información proporcionada.
Sintaxis
BOOL SisCreateRestoreStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisRestoreStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
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:\". El volumen no puede ser el volumen del sistema ni del arranque.
-
sisRestoreStructure [out]
-
Estructura de restauración de SIS devuelta. El autor de la llamada debe tratar esta estructura como opaca.
-
commonStoreRootPathname [out]
-
Nombre completo de la ruta de acceso del almacén común del volumen especificado. Por ejemplo, "c:\SIS Common Store".
-
countOfCommonStoreFilesToRestore [out]
-
Número de archivos enumerados en el parámetro commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Puntero a una matriz de nombres de archivo que especifica la lista de archivos internos usados por SIS para administrar el volumen especificado. Estos archivos se deben restaurar 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 establece el entorno de restauración en el volumen especificado de la manera en que SisCreateBackupStructure establece el entorno de copia de seguridad en el volumen especificado.
Tenga en cuenta que esta función no identificará necesariamente el archivo o los archivos de almacén común correspondientes a un conjunto de vínculos SIS en el medio de copia de seguridad si esos archivos o archivos de almacén comunes siguen existiendo en el disco. El contenido del flujo de datos de un archivo de almacén común nunca cambia una vez creado, por lo que si el archivo ya existe en el disco no es necesario restaurarlo.
Los nombres de archivo de almacén común son únicos globalmente para garantizar la integridad de la operación de restauración, incluso si no se produce en el mismo volumen habilitado para SIS al que se ha accedido la operación de copia de seguridad.
Una vez completada la operación de restauración, desasigne la memoria usada por la matriz commonStoreFilesToRestore 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 |
|