Función SisRestoredLink
La función SisRestoredLink devuelve los nombres del archivo o los archivos de almacén común a los que apunta el vínculo SIS restaurado especificado.
Sintaxis
BOOL SisRestoredLink(
_In_ PVOID sisRestoreStructure,
_In_ PWCHAR restoredFileName,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
Parámetros
-
sisRestoreStructure [in]
-
Puntero a una estructura de restauración de SIS devuelta desde SisCreateRestoreStructure.
-
restoredFileName [in]
-
Nombre de archivo completo del archivo de vínculo SIS restaurado.
-
reparseData [in]
-
Puntero al contenido del punto de reanálisis del SIS. Este punto de reanálisis contiene datos que describen el vínculo siS restaurado. Para recuperar los datos del punto de reanálisis de un archivo, use el código de control FSCTL_GET_REPARSE_POINT .
-
reparseDataSize [in]
-
Tamaño del contenido del punto de reanálisis del SIS al que apunta reparseData, en bytes.
-
countOfCommonStoreFilesToRestore [out]
-
Número de archivos enumerados en el parámetro commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Puntero a una matriz de nombres de archivo de almacén común. Estos archivos se deben restaurar al mismo tiempo y de la misma manera que los archivos de almacén común solicitados por SisCSFilesToBackupForLink.
Si el valor del parámetro countOfCommonStoreFilesToRestore no es 0, el valor del parámetro commonStoreFilesToRestore contendrá los nombres de los archivos de almacén comunes que se van a restaurar como resultado de restaurar el vínculo SIS. Si el valor es 0, los archivos de almacén común se han devuelto una vez o ya están presentes en el volumen.
Valor devuelto
Esta función devuelve TRUE si se completa correctamente y FALSE de lo contrario. Llame a GetLastError para obtener más información sobre el motivo por el que se produjo un error en la llamada.
Comentarios
Debe llamar a esta función para cada vínculo de SIS que se ha restaurado.
Esta función devolverá cada archivo de almacén común como máximo una vez para cada operación de restauración; cualquier intento de restaurar vínculos SIS adicionales que vean el mismo archivo de almacén común no dará lugar a que se devuelva ese nombre de archivo de almacén común.
Esta función no devolverá un archivo de almacén común que tampoco se devolvió en una llamada a SisCSFilesToBackupForLink durante la operación de copia de seguridad, suponiendo que los datos de análisis de SIS almacenados en el medio no estén dañados.
Al restaurar un vínculo SIS, la operación de restauración solo debe crear el archivo disperso adecuado, inicializar los intervalos asignados y, a continuación, escribir los datos de análisis de SIS exactamente como se leyó durante la operación de copia de seguridad. Es fundamental que la operación de restauración cree archivos dispersos con intervalos no asignados en lugar de archivos dispersos (o archivos no dispersos) inicializados con ceros.
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 común siguen existiendo en el disco. El contenido de un flujo de datos del 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.
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 |
|