InternetWriteFile-Funktion (wininet.h)

  • Artikel

Schreibt Daten in eine geöffnete Internetdatei.

Syntax

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

Parameter

[in] hFile

Handle, das von einem vorherigen Aufruf von FtpOpenFile oder einem von HttpSendRequestEx gesendetenHINTERNET-Handle zurückgegeben wurde.

[in] lpBuffer

Zeiger auf einen Puffer, der die Daten enthält, die in die Datei geschrieben werden sollen.

[in] dwNumberOfBytesToWrite

Anzahl der Bytes, die in die Datei geschrieben werden sollen.

[out] lpdwNumberOfBytesWritten

Zeiger auf eine Variable, die die Anzahl der in die Datei geschriebenen Bytes empfängt. InternetWriteFile legt diesen Wert vor der Arbeit oder Fehlerüberprüfung auf Null fest.

Rückgabewert

Gibt TRUE zurück, wenn die Funktion erfolgreich ist, oder andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Eine Anwendung kann bei Bedarf auch InternetGetLastResponseInfo verwenden.

Hinweise

Wenn die Anwendung Daten sendet, muss sie InternetCloseHandle aufrufen, um die Datenübertragung zu beenden.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

Hinweis WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wininet.h
Bibliothek Wininet.lib
DLL Wininet.dll

Weitere Informationen

Allgemeine Funktionen

WinINet-Funktionen