DsBackupOpenFile-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. Verwenden Sie ab Windows Vista stattdessen den Volume Shadow Copy Service (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 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.
-
ERROR_ACCESS_DENIED
-
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.
-
ERROR_INVALID_PARAMETER
-
hbc, szAttachmentName oder pliFileSize sind ungültig.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsBackupOpenFileW (Unicode) und DsBackupOpenFileA (ANSI) |