Fonction InternetSetFilePointer (wininet.h)

Article
08/27/2023

Définit une position de fichier pour InternetReadFile. Il s’agit d’un appel synchrone ; Toutefois, les appels ultérieurs à InternetReadFile peuvent bloquer ou retourner en attente si les données ne sont pas disponibles à partir du cache et que le serveur ne prend pas en charge l’accès aléatoire.

Syntaxe

DWORD InternetSetFilePointer(
  [in]      HINTERNET hFile,
  [in]      LONG      lDistanceToMove,
  [in, out] PLONG     lpDistanceToMoveHigh,
  [in]      DWORD     dwMoveMethod,
  [in]      DWORD_PTR dwContext
);

Paramètres

[in] hFile

Handle retourné à partir d’un appel précédent à InternetOpenUrl (sur une URL HTTP ou HTTPS) ou HttpOpenRequest (à l’aide du verbe HTTP GET ou HEAD et passé à HttpSendRequest ou HttpSendRequestEx). Ce handle ne doit pas avoir été créé avec l’INTERNET_FLAG_DONT_CACHE ou INTERNET_FLAG_NO_CACHE_WRITE valeur définie.

[in] lDistanceToMove

32 bits d’ordre inférieur d’un nombre d’octets 64 bits signé pour déplacer le pointeur de fichier. Internet Explorer 7 et versions antérieures : InternetSetFilePointer utilisé pour déplacer le pointeur uniquement dans les limites d’un long. Lors de l’appel de cette version antérieure de la fonction, lpDistanceToMoveHigh est réservé et doit être défini sur 0. Une valeur positive déplace le pointeur vers l’avant dans le fichier ; une valeur négative la déplace vers l’arrière.

[in, out] lpDistanceToMoveHigh

Pointeur vers les 32 bits d’ordre supérieur de la distance 64 bits signée à déplacer. Si vous n’avez pas besoin des 32 bits d’ordre élevé, ce pointeur doit avoir la valeur NULL. S’il n’est pas NULL, ce paramètre reçoit également l’ordre DWORD élevé de la nouvelle valeur du pointeur de fichier. Une valeur positive déplace le pointeur vers l’avant dans le fichier ; une valeur négative la déplace vers l’arrière. Internet Explorer 7 et versions antérieures : InternetSetFilePointer utilisé pour déplacer le pointeur uniquement dans les limites d’un long. Lors de l’appel de cette version antérieure de la fonction, lpDistanceToMoveHigh est réservé et doit être défini sur 0.

[in] dwMoveMethod

Point de départ du déplacement du pointeur de fichier. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
FILE_BEGIN	Le point de départ est zéro ou le début du fichier. Si FILE_BEGIN est spécifié, lDistanceToMove est interprété comme un emplacement non signé pour le nouveau pointeur de fichier.
FILE_CURRENT	La valeur actuelle du pointeur de fichier est le point de départ.
FILE_END	La position de fin du fichier actuelle est le point de départ. Cette méthode échoue si la longueur du contenu est inconnue.

[in] dwContext

Ce paramètre est réservé et doit être 0.

Valeur retournée

Si la fonction réussit, elle retourne la position du fichier actuel. Une valeur de retour de INVALID_SET_FILE_POINTER indique un échec potentiel et doit être suivie d’un appel à GetLastError.

Étant donné que INVALID_SET_FILE_POINTER est une valeur valide pour le DWORD de bas ordre du nouveau pointeur de fichier, l’appelant doit case activée à la fois la valeur de retour de la fonction et le code d’erreur retourné par GetLastError pour déterminer si une erreur s’est produite ou non. Si une erreur s’est produite, la valeur de retour d’InternetSetFilePointer est INVALID_SET_FILE_POINTER et GetLastError renvoie une valeur autre que NO_ERROR.

Si la fonction réussit et que lpDistanceToMoveHigh a la valeur NULL, la valeur de retour est la valeur DWORD d’ordre inférieur du nouveau pointeur de fichier.

Notez que si la fonction retourne une valeur autre que INVALID_SET_FILE_POINTER, l’appel à InternetSetFilePointer a réussi et il n’est pas nécessaire d’appeler GetLastError.

Si la fonction réussit et que lpDistanceToMoveHigh n’a pas la valeur NULL, la valeur de retour est la valeur DWORD d’ordre inférieur du nouveau pointeur de fichier et lpDistanceToMoveHigh contient l’ordre supérieur DWORD du nouveau pointeur de fichier.

Si un nouveau pointeur de fichier est une valeur négative, la fonction échoue, le pointeur de fichier n’est pas déplacé et le code retourné par GetLastError est ERROR_NEGATIVE_SEEK.

Si lpDistanceToMoveHigh a la valeur NULL et que la nouvelle position du fichier ne correspond pas à une valeur 32 bits, la fonction échoue et retourne INVALID_SET_FILE_POINTER.

Remarques

Cette fonction ne peut pas être utilisée une fois que la fin du fichier a été atteinte par InternetReadFile.

Pour les handles HINTERNET créés par HttpOpenRequest et envoyés par HttpSendRequestEx, un appel à HttpEndRequest doit être effectué sur le handle avant l’utilisation d’InternetSetFilePointer.

InternetSetFilePointer ne peut pas être utilisé de manière fiable si la longueur du contenu est inconnue.

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

InternetSetFilePointer a changé au fil du temps. Dans Internet Explorer 7 et versions antérieures, il était utilisé pour déplacer le pointeur uniquement dans les limites d’un long. Lors de l’appel de cette version antérieure de la fonction, lDistanceToMove contient la valeur entière. Une valeur positive déplace le pointeur vers l’avant dans le fichier ; une valeur négative la déplace vers l’arrière. lpDistanceToMoveHigh est réservé et est défini sur 0. Dans les versions actuelles, lpDistanceToMoveHigh est une valeur significative et où toute valeur négative serait indiquée.

Note WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

Fonctions courantes

Fonctions WinINet

Partager via