Función DsBackupOpenFile
[Esta función está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. A partir de Windows Vista, use el Servicio de instantáneas de volumen (VSS) en su lugar.
La función DsBackupOpenFile abre el archivo especificado y realiza las operaciones de cliente y servidor necesarias para preparar el archivo para la copia de seguridad.
Sintaxis
HRESULT DsBackupOpenFile(
_In_ HBC hbc,
_In_ LPCTSTR szAttachmentName,
_In_ DWORD cbReadHintSize,
_Out_ LARGE_INTEGER *pliFileSize
);
Parámetros
-
hbc [in]
-
Contiene el identificador de contexto de copia de seguridad obtenido con la función DsBackupPrepare .
-
szAttachmentName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del archivo de copia de seguridad que se va a abrir.
-
cbReadHintSize [in]
-
Contiene el tamaño posible, en bytes, del búfer pasado como argumento pvBuffer en la función DsBackupRead . Las funciones de copia de seguridad usan este valor como sugerencia para optimizar el tráfico de red. Este valor debe ser un múltiplo de 8192 y debe ser mayor o igual que 24576.
-
pliFileSize [out]
-
Puntero a un valor de LARGE_INTEGER que recibe el tamaño, en bytes, del archivo de copia de seguridad abierto.
Valor devuelto
Devuelve S_OK si la función es correcta o un código de error Win32 o RPC en caso contrario. En la lista siguiente se enumeran otros códigos de error posibles.
-
ERROR_ACCESS_DENIED
-
El autor de la llamada no tiene los privilegios de acceso adecuados para llamar a esta función. La función DsSetAuthIdentity se puede usar para establecer las credenciales que se usarán para las funciones de copia de seguridad y restauración.
-
ERROR_INVALID_PARAMETER
-
hbc, szAttachmentName o pliFileSize no son válidos.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DsBackupOpenFileW (Unicode) y DsBackupOpenFileA (ANSI) |