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
Ntdsbcli.h
Bibliothek
Ntdsbcli.lib
DLL
Ntdsbcli.dll

Siehe auch

DsBackupOpenFile

DsBackupPrepare

DsBackupFree

Sichern eines Active Directory-Servers

Verzeichnissicherungsfunktionen