BackupSeek, fonction (winbase.h)
La fonction BackupSeek recherche le transfert dans un flux de données initialement accessible à l’aide de la fonction BackupRead ou BackupWrite .
Syntaxe
BOOL BackupSeek(
[in] HANDLE hFile,
[in] DWORD dwLowBytesToSeek,
[in] DWORD dwHighBytesToSeek,
[out] LPDWORD lpdwLowByteSeeked,
[out] LPDWORD lpdwHighByteSeeked,
[in] LPVOID *lpContext
);
Paramètres
[in] hFile
Gérez le fichier ou le répertoire. Ce handle est créé à l’aide de la fonction CreateFile .
Le handle doit être synchrone (sans couverture). Cela signifie que l’indicateur FILE_FLAG_OVERLAPPED ne doit pas être défini lorsque CreateFile est appelé. Cette fonction ne valide pas que le handle qu’elle reçoit est synchrone. Elle ne retourne donc pas de code d’erreur pour un handle synchrone, mais l’appeler avec un handle asynchrone (qui se chevauche) peut entraîner des erreurs subtiles qui sont très difficiles à déboguer.
[in] dwLowBytesToSeek
Partie d’ordre inférieur du nombre d’octets à rechercher.
[in] dwHighBytesToSeek
Partie d’ordre élevé du nombre d’octets à rechercher.
[out] lpdwLowByteSeeked
Pointeur vers une variable qui reçoit les bits d’ordre inférieur du nombre d’octets que la fonction recherche réellement.
[out] lpdwHighByteSeeked
Pointeur vers une variable qui reçoit les bits d’ordre élevé du nombre d’octets que la fonction recherche réellement.
[in] lpContext
Pointeur vers une structure de données interne utilisée par la fonction . Cette structure doit être la même que celle qui a été initialisée par la fonction BackupRead ou BackupWrite . Une application ne doit pas toucher au contenu de cette structure.
Valeur retournée
Si la fonction peut rechercher la quantité demandée, la fonction retourne une valeur différente de zéro.
Si la fonction n’a pas pu rechercher la quantité demandée, la fonction retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Les applications utilisent la fonction BackupSeek pour ignorer des parties d’un flux de données qui provoquent des erreurs. Cette fonction ne recherche pas dans les en-têtes de flux. Par exemple, cette fonction ne peut pas être utilisée pour ignorer le nom du flux. Si une application tente de rechercher au-delà de la fin d’un sous-flux, la fonction échoue, les paramètres lpdwLowByteSeeked et lpdwHighByteSeeked indiquent le nombre réel d’octets recherchés par la fonction, et la position du fichier est placée au début de l’en-tête de flux suivant.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |