Fonction DsBackupGetDatabaseNames
[Cette fonction peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. À compter de Windows Vista, utilisez le service VSS (Volume Shadow Copy Service) à la place.]
La fonction DsBackupGetDatabaseNames obtient la liste des fichiers de base de données à sauvegarder pour le contexte de sauvegarde donné.
Syntaxe
HRESULT DsBackupGetDatabaseNames(
_In_ HBC hbc,
_Out_ LPTSTR *pszAttachmentInfo,
_Out_ LPDWORD pcbSize
);
Paramètres
-
hbc [in]
-
Contient le handle de contexte de sauvegarde obtenu avec la fonction DsBackupPrepare .
-
pszAttachmentInfo [out]
-
Pointeur vers un pointeur de chaîne qui reçoit la liste des noms de fichiers de base de données en tant que chemins UNC. Cette valeur doit être initialisée sur NULL avant d’appeler DsBackupGetDatabaseNames.
Cette liste reçoit une liste de chaînes simples terminées par null.
Cette mémoire tampon est allouée par la fonction DsBackupGetDatabaseNames et doit être libérée quand elle n’est plus nécessaire en appelant la fonction DsBackupFree .
Le premier caractère de chaque nom de fichier contient l’une des constantes BFT qui identifie le type de nom. La fonction DsRestoreGetDatabaseLocations fournit uniquement les types de noms suivants.
-
BFT_NTDS_DATABASE
-
Le fichier est un fichier de base de données NTDS. Ce fichier doit être copié dans le fichier identifié comme BFT_NTDS_DATABASE lorsque les données sont restaurées.
-
BFT_LOG
-
Le fichier est un fichier journal. Tous les fichiers journaux sont copiés dans le répertoire identifié comme BFT_LOG_DIR lorsque les données sont restaurées.
-
BFT_PATCH_FILE
-
Le fichier est un fichier patch. Tous les fichiers correctifs sont copiés dans le répertoire identifié comme BFT_CHECKPOINT_DIR lorsque les données sont restaurées.
pcbSize [out]
Pointeur vers la valeur DWORD qui reçoit la taille, en octets, de la mémoire tampon pszAttachmentInfo .
Valeur retournée
Retourne S_OK si la fonction réussit ou si un code d’erreur Win32 ou RPC est différent. La liste suivante répertorie d’autres codes d’erreur possibles.
-
ERROR_ACCESS_DENIED
-
L’appelant ne dispose pas des privilèges d’accès appropriés pour appeler cette fonction. La fonction DsSetAuthIdentity peut être utilisée pour définir les informations d’identification à utiliser pour les fonctions de sauvegarde et de restauration.
-
ERROR_INVALID_PARAMETER
-
hbc, pszAttachmentInfo ou pcbSize ne sont pas valides.
-
ERROR_NOT_ENOUGH_MEMORY
-
Un échec d’allocation de mémoire s’est produit.
Notes
La fonction DsBackupGetDatabaseNames fournit une liste des fichiers de base de données nécessaires pour une sauvegarde. Une sauvegarde complète se compose des fichiers de base de données et des fichiers journaux fournis par la fonction DsBackupGetBackupLogs . Les sauvegardes incrémentielles des serveurs Active Directory ne sont pas prises en charge.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
DsBackupGetDatabaseNamesW (Unicode) et DsBackupGetDatabaseNamesA (ANSI) |