Expand Minimize

InternetWriteFile function

Writes data to an open Internet file.

Syntax


BOOL InternetWriteFile(
  _In_   HINTERNET hFile,
  _In_   LPCVOID lpBuffer,
  _In_   DWORD dwNumberOfBytesToWrite,
  _Out_  LPDWORD lpdwNumberOfBytesWritten
);

Parameters

hFile [in]

Handle returned from a previous call to FtpOpenFile or an HINTERNET handle sent by HttpSendRequestEx.

lpBuffer [in]

Pointer to a buffer that contains the data to be written to the file.

dwNumberOfBytesToWrite [in]

Number of bytes to be written to the file.

lpdwNumberOfBytesWritten [out]

Pointer to a variable that receives the number of bytes written to the file. InternetWriteFile sets this value to zero before doing any work or error checking.

Return value

Returns TRUE if the function succeeds, or FALSE otherwise. To get extended error information, call GetLastError. An application can also use InternetGetLastResponseInfo when necessary.

Remarks

When the application is sending data, it must call InternetCloseHandle to end the data transfer.

Like all other aspects of the WinINet API, this function cannot be safely called from within DllMain or the constructors and destructors of global objects.

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Library

Wininet.lib

DLL

Wininet.dll

See also

Common Functions
WinINet Functions

 

 

Show:
© 2014 Microsoft