DsBackupGetBackupLogs fonction)

[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. à partir de Windows Vista, utilisez Service VSS (VSS) à la place.]

La fonction DsBackupGetBackupLogs obtient la liste des fichiers journaux qui doivent être sauvegardés pour le contexte de sauvegarde donné.

Syntaxe

HRESULT DsBackupGetBackupLogs(
  _In_  HBC     hbc,
  _Out_ LPTSTR  *pszBackupLogFiles,
  _Out_ LPDWORD pcbSize
);

Paramètres

Hbc [ dans]

Contient le descripteur de contexte de sauvegarde obtenu avec la fonction DsBackupPrepare .

pszBackupLogFiles [ à]

Pointeur vers un pointeur de chaîne qui reçoit la liste de noms de fichiers journaux sous forme de chemins d’accès UNC. Initialisez cette valeur sur null avant d’appeler DsBackupGetBackupLogs.

Cette liste reçoit une liste double terminée par un caractère null de chaînes uniques se terminant par null.

Cette mémoire tampon est allouée par la fonction DsBackupGetBackupLogs et doit être libérée lorsqu’elle n’est plus nécessaire en appelant la fonction DsBackupFree .

Le premier caractère de chaque nom de fichier contient une des constantes BFT qui identifient le type de nom.

PCB [ à]

Pointeur vers une valeur DWORD qui reçoit la taille, en octets, de la mémoire tampon pszBackupLogFiles .

Valeur retournée

Retourne S _ OK si la fonction réussit ou un code d’erreur Win32 ou RPC dans le cas contraire. La liste suivante répertorie les autres codes d’erreur possibles.

ERREUR d' _ accès _ refusé

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.

paramètre d’erreur _ non valide _

Hbc, pszBackupLogFiles ou PCB n’est pas valide.

ERREUR _ de _ mémoire insuffisante _

Un échec d’allocation de mémoire s’est produit.

Remarques

La fonction DsBackupGetBackupLogs fournit une liste des fichiers journaux nécessaires pour une sauvegarde. Une sauvegarde complète se compose des fichiers de base de données fournis par la fonction DsBackupGetDatabaseNames et des fichiers journaux. 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
Ntdsbcli. h
Bibliothèque
Ntdsbcli. lib
DLL
Ntdsbcli.dll
Noms Unicode et ANSI
DsBackupGetBackupLogsW (Unicode) et DsBackupGetBackupLogsA (ANSI)

Voir aussi

DsBackupFree

DsBackupGetDatabaseNames

Constantes BFT

Sauvegarde d’un serveur de Active Directory

Fonctions de sauvegarde d’annuaire