Fonction InternetWriteFile (wininet.h)

  • Article

Écrit des données dans un fichier Internet ouvert.

Syntaxe

BOOL InternetWriteFile(
  [in]  HINTERNET hFile,
  [in]  LPCVOID   lpBuffer,
  [in]  DWORD     dwNumberOfBytesToWrite,
  [out] LPDWORD   lpdwNumberOfBytesWritten
);

Paramètres

[in] hFile

Handle retourné par un appel précédent à FtpOpenFile ou un handle HINTERNET envoyé par HttpSendRequestEx.

[in] lpBuffer

Pointeur vers une mémoire tampon qui contient les données à écrire dans le fichier.

[in] dwNumberOfBytesToWrite

Nombre d’octets à écrire dans le fichier.

[out] lpdwNumberOfBytesWritten

Pointeur vers une variable qui reçoit le nombre d’octets écrits dans le fichier. InternetWriteFile définit cette valeur sur zéro avant d’effectuer un travail ou une vérification des erreurs.

Valeur retournée

Retourne TRUE si la fonction réussit, ou FALSE dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Une application peut également utiliser InternetGetLastResponseInfo si nécessaire.

Remarques

Lorsque l’application envoie des données, elle doit appeler InternetCloseHandle pour mettre fin au transfert de données.

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.

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