DsBackupGetDatabaseNames-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 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 Aufruf von DsBackupGetDatabaseNames mit NULL initialisiert werden.
Diese Liste empfängt eine liste mit doppeltem NULL-Ende beendeter Zeichenfolgen.
Dieser Puffer wird von der DsBackupGetDatabaseNames-Funktion zugeordnet und muss freigegeben werden, wenn er durch Aufrufen der DsBackupFree-Funktion nicht mehr benötigt 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 Namenstypen bereit.
-
BFT_NTDS_DATABASE
-
Die Datei ist eine NTDS-Datenbankdatei. Diese Datei sollte in die Datei kopiert werden, die als BFT_NTDS_DATABASE identifiziert wird, wenn die Daten wiederhergestellt werden.
-
BFT_LOG
-
Die Datei ist eine Protokolldatei. Alle Protokolldateien werden in das Verzeichnis kopiert, das bei der Wiederherstellung der Daten als BFT_LOG_DIR identifiziert wird.
-
BFT_PATCH_FILE
-
Die Datei ist eine Patchdatei. Alle Patchdateien werden in das Verzeichnis kopiert, das bei der Wiederherstellung der Daten als BFT_CHECKPOINT_DIR identifiziert wird.
pcbSize [out]
Zeiger auf den DWORD-Wert , der die Größe des puffers pszAttachmentInfo 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, pszAttachmentInfo oder pcbSize sind ungültig.
-
ERROR_NOT_ENOUGH_MEMORY
-
Ein Speicherbelegungsfehler ist aufgetreten.
Bemerkungen
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) |
WindowsServer 2008 |
| Header |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
DsBackupGetDatabaseNamesW (Unicode) und DsBackupGetDatabaseNamesA (ANSI) |