DsBackupRead-Funktion
[Diese Funktion ist für die Verwendung in den Im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Ab Windows Vista verwenden Sie stattdessen Volumeschattenkopie-Dienst (VSS).]
Die DsBackupRead-Funktion liest einen Datenblock aus der aktuellen geöffneten Datei in einen Puffer. Es wird erwartet, dass die Clientanwendung diese Funktion wiederholt aufruft, bis die gesamte Sicherungsdatei empfangen wurde. Die DsBackupOpenFile-Funktion bietet die gesamte Größe der Sicherungsdatei.
Syntax
HRESULT DsBackupRead(
_In_ HBC hbc,
_In_ PVOID pvBuffer,
_In_ DWORD cbBuffer,
_Out_ PDWORD pcbRead
);
Parameter
-
hbc [ In]
-
Enthält das Sicherungskontexthand handle, das mit der DsBackupPrepare-Funktion ermittelt wurde.
-
pvBuffer [ In]
-
Zeiger auf einen Puffer, der die Daten empfängt. Dieser Puffer muss mindestens die Größe cbBuffer-Bytes haben.
-
cbBuffer [ In]
-
Enthält die Größe des Puffers bei pvBuffer in Bytes. Dieser Wert muss ein Vielfaches von 8192 und größer oder gleich 24576 sein.
-
vorlesen [ out]
-
Zeiger auf einen DWORD-Wert, der die tatsächliche Anzahl gelesener Bytes empfängt. Dies kann kleiner als die Anzahl der angeforderten Bytes sein, da einige Transporte den übertragenen Puffer fragmentieren, anstatt den gesamten Puffer mit Daten zu füllen.
Rückgabewert
Gibt S _ OK zurück, wenn die Funktion erfolgreich ist, andernfalls ein Win32- oder RPC-Fehlercode. Mögliche Fehlercodes:
-
FEHLER _ UNGÜLTIGER _ PARAMETER
-
Mindestens ein Parameter ist ungültig.
-
FEHLERHAND _ _ HANDLE EOF
-
Das Ende der Sicherungsdatei wurde erreicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|