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 내에서 또는 전역 개체의 생성자 및 소멸자에서 안전하게 호출할 수 없습니다.

참고 WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하면 안 됩니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 wininet.h
라이브러리 Wininet.lib
DLL Wininet.dll

추가 정보

공통 함수

WinINet 함수