Fonction DsSetCurrentBackupLog

Article
06/13/2023

[Cette fonction est disponible pour une utilisation 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 plutôt le service VSS (Volume Shadow Copy Service ).

La fonction DsSetCurrentBackupLog définit le numéro de journal de sauvegarde actuel après une restauration réussie. Étant donné que services de domaine Active Directory prennent uniquement en charge la journalisation circulaire, cette fonction n’est normalement pas utilisée.

Syntaxe

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

Paramètres

szServerName [in]: Pointeur vers une chaîne terminée par null qui contient le nom du serveur pour lequel définir le numéro de journal de sauvegarde. Les barres obliques inverses précédentes sont facultatives. Le serveur doit être le même ordinateur à partir duquel cette fonction est appelée. Le nom du serveur ne peut pas contenir de caractères de soulignement (_). Un exemple de nom de serveur est « \\server1 ».
dwCurrentLog [in]: Contient le numéro de journal de sauvegarde à définir.

Valeur retournée

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

ERROR_INVALID_PARAMETER: Un ou plusieurs paramètres ne sont pas valides.
ERROR_NOT_ENOUGH_MEMORY: Un échec d’allocation de mémoire s’est produit.

Notes

Il n’est normalement 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 réussir jusqu’à ce qu’une sauvegarde complète soit effectuée.

Spécifications

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

Partager via