DsSetCurrentBackupLog 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 DsSetCurrentBackupLog définit le numéro de journal de sauvegarde actuel après une restauration réussie. Étant donné que les Active Directory Domain Services prennent uniquement en charge la journalisation circulaire, cette fonction n’est généralement pas utilisée.

Syntaxe

HRESULT DsSetCurrentBackupLog(
  _In_ LPCWSTR szServerName,
  _In_ DWORD   dwCurrentLog
);

Paramètres

szServerName [ dans]

Pointeur vers une chaîne se terminant par un caractère null qui contient le nom du serveur pour lequel le numéro de journal de sauvegarde doit être défini. Les barres obliques inverses précédentes sont facultatives. Le serveur doit être le même que celui à partir duquel cette fonction est appelée. Le nom du serveur ne peut pas contenir de caractères de soulignement ( _ ). Exemple de nom de serveur \ \ : « serveur1 ».

dwCurrentLog [ dans]

Contient le numéro de journal de sauvegarde à définir.

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 codes d’erreur possibles.

paramètre d’erreur _ non valide _

Un ou plusieurs paramètres ne sont pas valides.

ERREUR _ de _ mémoire insuffisante _

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

Remarques

Normalement, il n’est pas nécessaire d’appeler la fonction DsSetCurrentBackupLog . Les fonctions de sauvegarde déterminent et définissent automatiquement le dernier numéro de journal sauvegardé. Utilisez DsSetCurrentBackupLog pour empêcher une autre sauvegarde incrémentielle de se dérouler jusqu’à ce qu’une sauvegarde complète soit effectuée.

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
DsSetCurrentBackupLogW (Unicode) et DsSetCurrentBackupLogA (ANSI)

Voir aussi

Sauvegarde et restauration d’un serveur Active Directory

Fonctions de sauvegarde d’annuaire