Leer en inglés

Compartir a través de


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.

Sintaxis

HRESULT DsBackupRead(
  _In_  HBC    hbc,
  _In_  PVOID  pvBuffer,
  _In_  DWORD  cbBuffer,
  _Out_ PDWORD pcbRead
);

Parámetros

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.

Valor devuelto

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.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Encabezado
Ntdsbcli.h
Biblioteca
Ntdsbcli.lib
Archivo DLL
Ntdsbcli.dll

Consulte también

DsBackupOpenFile

DsBackupPrepare

DsBackupFree

Copia de seguridad de un servidor de Active Directory

Funciones de copia de seguridad de directorio