Leggere in inglese

Condividi tramite


Funzione DsBackupRead

[Questa funzione è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. A partire da Windows Vista, usare invece il servizio Copia Shadow del volume (VSS ).

La funzione DsBackupRead legge un blocco di dati dal file aperto corrente in un buffer. L'applicazione client deve chiamare ripetutamente questa funzione fino a quando non viene ricevuto l'intero file di backup. La funzione DsBackupOpenFile fornisce l'intera dimensione del file di backup.

Sintassi

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

Parametri

hbc [in]

Contiene l'handle del contesto di backup ottenuto con la funzione DsBackupPrepare .

pvBuffer [in]

Puntatore a un buffer che riceve i dati. Questo buffer deve essere di dimensioni pari almeno ai byte cbBuffer .

cbBuffer [in]

Contiene le dimensioni, in byte, del buffer in pvBuffer. Questo valore deve essere un multiplo di 8192 e deve essere maggiore o uguale a 24576.

pcbRead [out]

Puntatore a un valore DWORD che riceve il numero effettivo di byte letti. Può essere minore del numero di byte richiesti perché alcuni trasportano il buffer trasmesso anziché riempire l'intero buffer con i dati.

Valore restituito

Restituisce S_OK se la funzione ha esito positivo o un codice di errore Win32 o RPC in caso contrario. I codici di errore possibili includono quanto segue.

ERROR_INVALID_PARAMETER

Uno o più parametri non sono validi.

ERROR_HANDLE_EOF

È stata raggiunta la fine del file di backup.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Intestazione
Ntdsbcli.h
Libreria
Ntdsbcli.lib
DLL
Ntdsbcli.dll

Vedi anche

DsBackupOpenFile

DsBackupPrepare

DsBackupFree

Backup di un server Active Directory

Funzioni di backup della directory