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

Siehe auch

DsBackupOpenFile

DsBackupPrepare

DsBackupFree

Sichern eines Active Directory-Servers

Verzeichnissicherungsfunktionen