Fonction DsBackupRead
[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 DsBackupRead lit un bloc de données du fichier ouvert actuel dans une mémoire tampon. L’application cliente doit appeler cette fonction à plusieurs reprises jusqu’à ce que le fichier de sauvegarde entier ait été reçu. La fonction DsBackupOpenFile fournit la taille entière du fichier de sauvegarde.
Syntaxe
HRESULT DsBackupRead(
_In_ HBC hbc,
_In_ PVOID pvBuffer,
_In_ DWORD cbBuffer,
_Out_ PDWORD pcbRead
);
Paramètres
-
hbc [in]
-
Contient le handle de contexte de sauvegarde obtenu avec la fonction DsBackupPrepare .
-
pvBuffer [in]
-
Pointeur vers une mémoire tampon qui reçoit les données. Cette mémoire tampon doit avoir au moins la taille des octets cbBuffer .
-
cbBuffer [in]
-
Contient la taille, en octets, de la mémoire tampon sur pvBuffer. Cette valeur doit être un multiple de 8192 et doit être supérieure ou égale à 24576.
-
pcbRead [out]
-
Pointeur vers une valeur DWORD qui reçoit le nombre réel d’octets lus. Cela peut être inférieur au nombre d’octets demandé, car certains transports fragmentent la mémoire tampon transmise au lieu de remplir l’intégralité de la mémoire tampon avec des données.
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. Les codes d’erreur possibles sont les suivants.
-
ERROR_INVALID_PARAMETER
-
Un ou plusieurs paramètres ne sont pas valides.
-
ERROR_HANDLE_EOF
-
La fin du fichier de sauvegarde a été atteinte.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|