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.
HRESULT DsBackupRead(
_In_ HBC hbc,
_In_ PVOID pvBuffer,
_In_ DWORD cbBuffer,
_Out_ PDWORD pcbRead
);
-
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.
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.
Requisito | Valore |
---|---|
Client minimo supportato |
Windows Vista |
Server minimo supportato |
Windows Server 2008 |
Intestazione |
|
Libreria |
|
DLL |
|