DsBackupOpenFile-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 Volumeschattenkopie-Dienst (VSS).]

Die DsBackupOpenFile-Funktion öffnet die angegebene Datei und führt die Client- und Servervorgänge aus, die zum Vorbereiten der Datei für die Sicherung erforderlich sind.

Syntax

HRESULT DsBackupOpenFile(
  _In_  HBC           hbc,
  _In_  LPCTSTR       szAttachmentName,
  _In_  DWORD         cbReadHintSize,
  _Out_ LARGE_INTEGER *pliFileSize
);

Parameter

hbc [ In]

Enthält das Sicherungskontexthandle, das mit der DsBackupPrepare-Funktion abgerufen wurde.

szAttachmentName [ In]

Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen der zu öffnenden Sicherungsdatei angibt.

cbReadHintSize [ In]

Enthält die mögliche Größe des Puffers in Bytes, der als pvBuffer-Argument in der DsBackupRead-Funktion übergeben wird. Die Sicherungsfunktionen verwenden diesen Wert als Hinweis, um den Netzwerkdatenverkehr zu optimieren. Dieser Wert muss ein Vielfaches von 8192 und größer oder gleich 24576 sein.

pliFileSize [ out]

Zeiger auf einen LARGE _ INTEGER-Wert, der die Größe der geöffneten Sicherungsdatei in Bytes empfängt.

Rückgabewert

Gibt S _ OK zurück, wenn die Funktion erfolgreich ist oder andernfalls ein Win32- oder RPC-Fehlercode vorliegt. In der folgenden Liste sind weitere mögliche Fehlercodes aufgeführt.

FEHLERZUGRIFF _ _ VERWEIGERT

Der Aufrufer verfügt nicht über die richtigen Zugriffsberechtigungen zum Aufrufen dieser Funktion. Die DsSetAuthIdentity-Funktion kann verwendet werden, um die Anmeldeinformationen festzulegen, die für die Sicherungs- und Wiederherstellungsfunktionen verwendet werden sollen.

FEHLER: _ UNGÜLTIGER _ PARAMETER

hbc, szAttachmentName oder pliFileSize sind ungültig.

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
Unicode- und ANSI-Name
DsBackupOpenFileW (Unicode) und DsBackupOpenFileA (ANSI)

Siehe auch

DsBackupRead

Sichern eines Active Directory-Servers

Verzeichnissicherungsfunktionen