Ler em inglês

Compartilhar via


Função DsBackupRead

[Essa função está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. A partir do Windows Vista, use o VSS (Serviço de Cópias de Sombra de Volume ).

A função DsBackupRead lê um bloco de dados do arquivo aberto atual em um buffer. Espera-se que o aplicativo cliente chame essa função repetidamente até que todo o arquivo de backup seja recebido. A função DsBackupOpenFile fornece todo o tamanho do arquivo de backup.

Sintaxe

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

Parâmetros

hbc [in]

Contém o identificador de contexto de backup obtido com a função DsBackupPrepare .

pvBuffer [in]

Ponteiro para um buffer que recebe os dados. Esse buffer deve ter pelo menos bytes cbBuffer de tamanho.

cbBuffer [in]

Contém o tamanho, em bytes, do buffer em pvBuffer. Esse valor deve ser um múltiplo de 8192 e deve ser maior ou igual a 24576.

pcbRead [out]

Ponteiro para um valor DWORD que recebe o número real de bytes lidos. Isso pode ser menor que o número de bytes solicitados porque alguns transportes fragmentam o buffer que está sendo transmitido em vez de preencher todo o buffer com dados.

Valor retornado

Retorna S_OK se a função for bem-sucedida ou um código de erro Win32 ou RPC caso contrário. Os códigos de erro possíveis incluem o seguinte.

ERROR_INVALID_PARAMETER

Um ou mais dos parâmetros não são válidos.

ERROR_HANDLE_EOF

O final do arquivo de backup foi atingido.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Cabeçalho
Ntdsbcli.h
Biblioteca
Ntdsbcli.lib
DLL
Ntdsbcli.dll

Confira também

DsBackupOpenFile

DsBackupPrepare

DsBackupFree

Fazendo backup de um servidor do Active Directory

Funções de backup de diretório