Fonction DsBackupOpenFile

Article
06/13/2023

[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 DsBackupOpenFile ouvre le fichier spécifié et effectue les opérations client et serveur nécessaires pour préparer le fichier pour la sauvegarde.

Syntaxe

HRESULT DsBackupOpenFile(
  _In_  HBC           hbc,
  _In_  LPCTSTR       szAttachmentName,
  _In_  DWORD         cbReadHintSize,
  _Out_ LARGE_INTEGER *pliFileSize
);

Paramètres

hbc [in]: Contient le handle de contexte de sauvegarde obtenu avec la fonction DsBackupPrepare .
szAttachmentName [in]: Pointeur vers une chaîne terminée par null qui spécifie le nom du fichier de sauvegarde à ouvrir.
cbReadHintSize [in]: Contient la taille possible, en octets, de la mémoire tampon passée en tant qu’argument pvBuffer dans la fonction DsBackupRead . Les fonctions de sauvegarde utilisent cette valeur comme indicateur pour optimiser le trafic réseau. Cette valeur doit être un multiple de 8192 et doit être supérieure ou égale à 24576.
pliFileSize [out]: Pointeur vers une valeur LARGE_INTEGER qui reçoit la taille, en octets, du fichier de sauvegarde ouvert.

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, szAttachmentName ou pliFileSize ne sont pas valides.

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	DsBackupOpenFileW (Unicode) et DsBackupOpenFileA (ANSI)

Voir aussi

DsBackupRead
Sauvegarde d’un serveur Active Directory
Fonctions de sauvegarde d’annuaire

Partager via