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 |
|
| Biblioteca |
|
| DLL |
|