InternetWriteFile 関数 (wininet.h)

開いているインターネット ファイルにデータを書き込みます。

構文

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

パラメーター

[in] hFile

以前の FtpOpenFile 呼び出しから返されたハンドル、または HttpSendRequestEx によって送信された HINTERNET ハンドル。

[in] lpBuffer

ファイルに書き込まれるデータを含むバッファーへのポインター。

[in] dwNumberOfBytesToWrite

ファイルに書き込まれるバイト数。

[out] lpdwNumberOfBytesWritten

ファイルに書き込まれたバイト数を受け取る変数へのポインター。 InternetWriteFile は、作業またはエラー チェックを行う前に、この値を 0 に設定します。

戻り値

関数が成功した場合は TRUE、それ以外の場合は FALSE を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 アプリケーションでは、必要に応じて InternetGetLastResponseInfo を使用することもできます。

解説

アプリケーションがデータを送信するときは、データ転送を終了するために InternetCloseHandle を呼び出す必要があります。

WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。

 

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	wininet.h
Library	Wininet.lib
[DLL]	Wininet.dll

関連項目

共通関数

WinINet 関数