InternetQueryDataAvailable 関数 (wininet.h)
サーバーにクエリを実行して、使用可能なデータの量を確認します。
構文
BOOL InternetQueryDataAvailable(
[in] HINTERNET hFile,
[out] LPDWORD lpdwNumberOfBytesAvailable,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
パラメーター
[in] hFile
InternetOpenUrl、FtpOpenFile、GopherOpenFile、または HttpOpenRequest 関数によって返されるハンドル。
[out] lpdwNumberOfBytesAvailable
使用可能なバイト数を受け取る変数へのポインター。 NULL を指定できます。
[in] dwFlags
このパラメーターは予約済みであり、0 である必要があります。
[in] dwContext
このパラメーターは予約済みであり、0 である必要があります。
戻り値
関数が成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 関数で一致するファイルが見つからない場合、 GetLastError は ERROR_NO_MORE_FILESを返します。
注釈
この関数は、 InternetReadFile の後続の呼び出しによってすぐに読み取ることができるデータのバイト数を返します。 現在使用可能なデータがなく、ファイルの末尾に到達していない場合、要求はデータが使用可能になるまで待機します。 残りのデータ量は、 InternetQueryDataAvailable の呼び出しによって示されたすべての使用可能なデータが読み取られるまで再計算されません。
HttpOpenRequest によって作成され、HttpSendRequestEx によって送信される HINTERNET ハンドルの場合、InternetQueryDataAvailable を使用する前に、ハンドルで HttpEndRequest の呼び出しを行う必要があります。
WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |