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 |
| 라이브러리 | Wininet.lib |
| DLL | Wininet.dll |