Función SisCSFilesToBackupForLink
La función SisCSFilesToBackupForLink devuelve información que describe los archivos de almacén comunes a los que apunta el vínculo SIS especificado.
Sintaxis
BOOL SisCSFilesToBackupForLink(
_In_ PVOID sisBackupStructure,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PVOID thisFileContext,
_Out_ PVOID *matchingFileContext,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Parámetros
-
sisBackupStructure [in]
-
Puntero a la estructura de copia de seguridad de SIS devuelta desde SisCreateBackupStructure.
-
reparseData [in]
-
Puntero al contenido del punto de reanálisis del SIS. Este punto de reanálisis contiene datos que describen un vínculo SIS. 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.
-
thisFileContext [out]
-
Puntero a una cadena de contexto proporcionada por la aplicación de copia de seguridad que llama a esta función. El contenido de esta cadena de contenido viene determinado por completo por esta aplicación de copia de seguridad y no lo interpreta la API de copia de seguridad de SIS. Este parámetro es opcional; si no se usa, establezca el valor de este parámetro en NULL. El valor de este parámetro no se procesará en este caso.
-
matchingFileContext [out]
-
Puntero doblemente indirecto a la cadena de contexto del vínculo SIS identificado por la información pasada en los cuatro primeros parámetros de esta función. Este parámetro es opcional; si no se proporciona una cadena de contexto como valor del parámetro thisFileContext , establezca el valor de este parámetro en NULL. El valor de este parámetro no se procesará en este caso.
-
countOfCommonStoreFilesToBackUp [out]
-
Número de archivos enumerados en el parámetro commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Puntero a una matriz de nombres de archivo. Estos archivos se deben realizar copias de seguridad al mismo tiempo y de la misma manera que los archivos de almacén comunes solicitados por SisCreateBackupStructure.
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
La aplicación de copia de seguridad solo debe llamar a esta función una vez para cada archivo de vínculo SIS del que se realiza una copia de seguridad.
La aplicación de copia de seguridad puede identificar un punto de reanálisis de SIS por su etiqueta, IO_REPARSE_TAG_SIS. Esta etiqueta se define en Winnt.h.
Si este punto de reanálisis identificado por el valor del parámetro reparseData describe la primera instancia de un archivo al que se va a realizar una copia de seguridad, esta función devolverá NULL como el valor del parámetro matchingFileContext e inicializará el valor de la matriz commonStoreFilesToBackUp de cadenas con los nombres del archivo o los archivos de almacén común de los que se va a realizar una copia de seguridad. De lo contrario, esta función establecerá el valor del parámetro matchingFileContext en la cadena de contexto correspondiente a la primera instancia del archivo especificado y establecerá el valor del parámetro countOfCommonStoreFilesToBackUp en 0. Si hay varios archivos de almacén comunes correspondientes al vínculo especificado, el valor del parámetro thisFileContext será la cadena de contexto correspondiente al primer archivo de almacén común devuelto en la matriz que es, commonStoreFilesToBackUp[0].
La versión actual de esta función devolverá, como máximo, un archivo de almacén común, pero es posible que en versiones futuras, varios archivos de almacén comunes puedan estar respaldados por varios archivos de almacén común, por ejemplo, uno para cada secuencia del archivo, por lo que la aplicación de copia de seguridad debe admitir varios archivos en cada llamada a esta función. En cualquier caso, cada archivo de almacén común se devolverá como máximo una vez para cada paso de copia de seguridad.
La aplicación de copia de seguridad debe realizar una copia de seguridad o restaurar el archivo o los archivos de almacén común identificados por el nombre de archivo o los nombres de archivo devueltos en el parámetro commonStoreFilesToBackUp . Independientemente de si hay un archivo de almacén común correspondiente, la aplicación de copia de seguridad debe hacer una copia de seguridad del archivo de vínculo SIS tal como existe en el disco, por ejemplo, como punto de reanálisis y un archivo disperso, y lo más probable es que no haya intervalos rellenados. La aplicación de copia de seguridad puede hacer una copia de seguridad o restaurar el archivo o los archivos de almacén común inmediatamente, posponer la copia de seguridad o mezclarlos juntos según sea necesario.
Una vez completada la operación de copia de seguridad, desasigne la memoria usada por la matriz commonStoreFilesToBackUp de cadenas llamando 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 |
|