Función DsBackupRead
[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 DsBackupRead lee un bloque de datos del archivo abierto actual en un búfer. Se espera que la aplicación cliente llame a esta función repetidamente hasta que se haya recibido todo el archivo de copia de seguridad. La función DsBackupOpenFile proporciona todo el tamaño del archivo de copia de seguridad.
HRESULT DsBackupRead(
_In_ HBC hbc,
_In_ PVOID pvBuffer,
_In_ DWORD cbBuffer,
_Out_ PDWORD pcbRead
);
-
hbc [in]
-
Contiene el identificador de contexto de copia de seguridad obtenido con la función DsBackupPrepare .
-
pvBuffer [in]
-
Puntero a un búfer que recibe los datos. Este búfer debe tener al menos bytes cbBuffer de tamaño.
-
cbBuffer [in]
-
Contiene el tamaño, en bytes, del búfer en pvBuffer. Este valor debe ser un múltiplo de 8192 y debe ser mayor o igual que 24576.
-
pcbRead [out]
-
Puntero a un valor DWORD que recibe el número real de bytes leídos. Puede ser menor que el número de bytes solicitados porque algunos transportes fragmentan el búfer que se transmite en lugar de rellenar todo el búfer con datos.
Devuelve S_OK si la función es correcta o un código de error Win32 o RPC en caso contrario. Los posibles códigos de error incluyen lo siguiente.
-
ERROR_INVALID_PARAMETER
-
Uno o más parámetros no son válidos.
-
ERROR_HANDLE_EOF
-
Se alcanzó el final del archivo de copia de seguridad.
Requisito | Value |
---|---|
Cliente mínimo compatible |
Windows Vista |
Servidor mínimo compatible |
Windows Server 2008 |
Encabezado |
|
Biblioteca |
|
Archivo DLL |
|