DsBackupGetBackupLogs-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 DsBackupGetBackupLogs-Funktion ruft die Liste der Protokolldateien ab, die für den angegebenen Sicherungskontext gesichert werden müssen.
Syntax
HRESULT DsBackupGetBackupLogs(
_In_ HBC hbc,
_Out_ LPTSTR *pszBackupLogFiles,
_Out_ LPDWORD pcbSize
);
Parameter
-
hbc [in]
-
Enthält das Sicherungskontexthandle, das mit der DsBackupPrepare-Funktion abgerufen wurde.
-
pszBackupLogFiles [out]
-
Zeiger auf einen Zeichenfolgenzeiger, der die Liste der Protokolldateinamen als UNC-Pfade empfängt. Initialisieren Sie diesen Wert auf NULL , bevor Sie DsBackupGetBackupLogs aufrufen.
Diese Liste empfängt eine liste mit doppeltem NULL-Ende beendeter Zeichenfolgen.
Dieser Puffer wird von der DsBackupGetBackupLogs-Funktion zugeordnet und muss freigegeben werden, wenn er nicht mehr benötigt wird, indem die DsBackupFree-Funktion aufgerufen wird.
Das erste Zeichen jedes Dateinamens enthält eine der BFT-Konstanten , die den Typ des Namens identifiziert.
-
pcbSize [out]
-
Zeiger auf den DWORD-Wert , der die Größe des Puffers pszBackupLogFiles 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, pszBackupLogFiles oder pcbSize ist ungültig.
-
ERROR_NOT_ENOUGH_MEMORY
-
Ein Speicherbelegungsfehler ist aufgetreten.
Bemerkungen
Die DsBackupGetBackupLogs-Funktion stellt eine Liste der Protokolldateien bereit, die für eine Sicherung erforderlich sind. Eine vollständige Sicherung besteht aus den Datenbankdateien, die von der DsBackupGetDatabaseNames-Funktion bereitgestellt werden, und den Protokolldateien. Inkrementelle Sicherungen von Active Directory-Servern werden nicht unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsBackupGetBackupLogsW (Unicode) und DsBackupGetBackupLogsA (ANSI) |