다음을 통해 공유

InternetSetStatusCallbackW 함수(wininet.h)

  • 아티클

InternetSetStatusCallback 함수는 WinINet 함수가 작업 중에 진행률로 호출할 수 있는 콜백 함수를 설정합니다.

통사론

INTERNET_STATUS_CALLBACK InternetSetStatusCallbackW(
  HINTERNET                hInternet,
  INTERNET_STATUS_CALLBACK lpfnInternetCallback
);

매개 변수

hInternet

콜백이 설정된 핸들입니다.

lpfnInternetCallback

진행률이 발생할 때 호출할 콜백 함수에 대한 포인터이거나 NULL 기존 콜백 함수를 제거합니다. 콜백 함수에 대한 자세한 내용은 InternetStatusCallback참조하세요.

반환 값

이전에 정의된 상태 콜백 함수가 없으면 NULL 이전에 정의된 상태 콜백 함수를 반환하거나 콜백 함수가 유효하지 않은 경우 INTERNET_INVALID_STATUS_CALLBACK 반환합니다.

발언

동기 함수와 비동기 함수는 모두 콜백 함수를 사용하여 이름 확인, 서버 연결 등의 요청 진행률을 나타냅니다. 콜백 함수는 비동기 작업에 필요합니다. 비동기 요청은 요청이 완료되었음을 나타내기 위해 INTERNET_STATUS_REQUEST_COMPLETE 사용하여 애플리케이션에 다시 호출합니다.

콜백 함수는 모든 핸들에서 설정할 수 있으며 파생 핸들에 의해 상속됩니다. 이전 콜백 값을 사용해야 하는 보류 중인 요청이 없으므로 internetSetStatusCallback사용하여 콜백 함수를 변경할 수 있습니다. 그러나 핸들에서 콜백 함수를 변경해도 InternetConnect반환된 것과 같이 파생 핸들의 콜백은 변경되지 않습니다. 각 수준에서 콜백 함수를 변경해야 합니다.

대부분의 WinINet 함수는 네트워크에서 여러 작업을 수행합니다. 각 작업을 완료하는 데 시간이 걸릴 수 있으며 각각이 실패할 수 있습니다.

장기 작업 중에 상태 정보를 표시하는 것이 바람직한 경우도 있습니다. 콜백 또는 비동기 함수가 보류 중인 한 제거할 수 없는 인터넷 상태 콜백 함수를 설정하여 상태 정보를 표시할 수 있습니다.

InternetSetStatusCallback시작한 후 시간이 많이 걸리는 네트워크 작업을 모니터링하기 위해 WinINet 함수 내에서 콜백 함수에 액세스할 수 있습니다.

참고lpfnInternetCallback 매개 변수에 지정된 콜백 함수는 dwContext가매개 변수인 경우 요청 핸들에 대한 비동기 작업에서 호출되지 않습니다. HttpOpenRequest 0(INTERNET_NO_CALLBACK)으로 설정되거나 InternetConnectdwContext 핸들이 0(INTERNET_NO_CALLBACK)으로 설정된 경우 연결 핸들로 설정됩니다.

WinINet API의 다른 모든 측면과 마찬가지로 이 함수는 DllMain 내에서 또는 전역 개체의 생성자 및 소멸자 내에서 안전하게 호출할 수 없습니다.

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

메모

wininet.h 헤더는 INTERNETSetStatusCallback을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
헤더 wininet.h

참고 항목

공통 함수

InternetStatusCallback

winINet Functions