DsBackupGetDatabaseNames-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 DsBackupGetDatabaseNames-Funktion ruft die Liste der Datenbankdateien ab, die für den angegebenen Sicherungskontext gesichert werden sollen.
Syntax
HRESULT DsBackupGetDatabaseNames(
_In_ HBC hbc,
_Out_ LPTSTR *pszAttachmentInfo,
_Out_ LPDWORD pcbSize
);
Parameter
-
hbc [ In]
-
Enthält das Sicherungskontexthandle, das mit der DsBackupPrepare-Funktion abgerufen wurde.
-
pszAttachmentInfo [ out]
-
Zeiger auf einen Zeichenfolgenzeiger, der die Liste der Datenbankdateinamen als UNC-Pfade empfängt. Dieser Wert muss vor dem Aufrufen von DsBackupGetDatabaseNames mit NULL initialisiert werden.
Diese Liste empfängt eine doppelt auf NULL endende Liste einzelner null-terminierte Zeichenfolgen.
Dieser Puffer wird von der DsBackupGetDatabaseNames-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. Die DsRestoreGetDatabaseLocations-Funktion stellt nur die folgenden Namentypen bereit.
-
BFT _ NTDS _ DATABASE
-
Die Datei ist eine NTDS-Datenbankdatei. Diese Datei sollte in die Datei kopiert werden, die beim Wiederherstellen der Daten als BFT _ NTDS _ DATABASE identifiziert wird.
-
BFT _ LOG
-
Die Datei ist eine Protokolldatei. Alle Protokolldateien werden in das Verzeichnis kopiert, das beim Wiederherstellen der Daten als BFT _ LOG _ DIR identifiziert wird.
-
_BFT-PATCHDATEI _
-
Die Datei ist eine Patchdatei. Alle Patchdateien werden in das Verzeichnis kopiert, das beim Wiederherstellen der Daten als BFT _ CHECKPOINT _ DIR identifiziert wird.
layoutSize [ out]
Zeiger auf den DWORD-Wert, der die Größe des pszAttachmentInfo-Puffers 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, pszAttachmentInfo oder designsSize sind ungültig.
-
FEHLER _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
-
Fehler bei der Speicherbelegung.
Hinweise
Die DsBackupGetDatabaseNames-Funktion stellt eine Liste der Datenbankdateien bereit, die für eine Sicherung erforderlich sind. Eine vollständige Sicherung besteht aus den Datenbankdateien und den Protokolldateien, die von der DsBackupGetBackupLogs-Funktion bereitgestellt werden. Inkrementelle Sicherungen von Active Directory-Servern werden nicht unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsBackupGetDatabaseNamesW (Unicode) und DsBackupGetDatabaseNamesA (ANSI) |