BackupSeek, fonction (winbase.h)

Article
03/03/2024

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

Voir aussi

BackupRead

BackupWrite

CreateFile