DsBackupRead-Funktion
[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie ab Windows Vista stattdessen den Volume Shadow Copy Service (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 stellt die gesamte Größe der Sicherungsdatei bereit.
Syntax
HRESULT DsBackupRead(
_In_ HBC hbc,
_In_ PVOID pvBuffer,
_In_ DWORD cbBuffer,
_Out_ PDWORD pcbRead
);
Parameter
-
hbc [in]
-
Enthält das Sicherungskontexthandle, das mit der DsBackupPrepare-Funktion abgerufen wurde.
-
pvBuffer [in]
-
Zeiger auf einen Puffer, der die Daten empfängt. Dieser Puffer muss mindestens cbBuffer-Bytes groß sein.
-
cbBuffer [in]
-
Enthält die Größe des Puffers bei pvBuffer in Bytes. Dieser Wert muss ein Vielfaches von 8192 sein und größer oder gleich 24576 sein.
-
pcbRead [out]
-
Zeiger auf einen DWORD-Wert , der die tatsächliche Anzahl gelesener Bytes empfängt. Dies kann weniger 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 oder andernfalls ein Win32- oder RPC-Fehlercode. Mögliche Fehlercodes sind:
-
ERROR_INVALID_PARAMETER
-
Mindestens ein Parameter ist ungültig.
-
ERROR_HANDLE_EOF
-
Das Ende der Sicherungsdatei wurde erreicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|