IXMLHTTPRequest2Callback::OnDataAvailable 메서드(msxml6.h)

클라이언트가 서버에서 HTTP 응답 데이터의 일부를 수신할 때 발생합니다.

구문

HRESULT OnDataAvailable(
  [in, optional] IXMLHTTPRequest2  *pXHR,
  [in, optional] ISequentialStream *pResponseStream
);

매개 변수

[in, optional] pXHR

초기 HTTP 요청입니다.

[in, optional] pResponseStream

응답 스트림 수신. 클라이언트는 ISequentialStream::Read 를 호출하여 데이터 처리를 시작하거나 전체 응답을 받을 때까지 기다릴 수 있습니다. 이 응답 스트림은 응용 프로그램이 사용자 지정 동기화를 구현할 필요가 없도록 읽기 및 쓰기 동시 작업을 방지하는 스트림 동기화 개체에 래핑됩니다.

반환 값

성공하면 S_OK를 반환합니다.

설명

이 콜백 함수가 반환되면 애플리케이션이 아직 전체 응답을 받지 못하더라도 HTTP 응답에서 데이터 처리를 시작할 수 있습니다. 그러나 이 콜백 함수가 반환될 때까지 요청에 대한 수신이 일시 중단됩니다. 또한 이 콜백은 단일 요청 중에 여러 번 호출할 수 있습니다.

이 콜백 함수는 차단해서는 안 되며 UI 업데이트와 같은 리소스 집약적인 작업을 수행하도록 해서는 안 됩니다.

사용자 지정 스트림은 OnDataAvailable이 실행되기 전에 ISequentialStream::Write에 대한 호출을 받습니다. 클라이언트는 사용자 지정 스트림에서 ISequentialStream::Read 를 호출하는 대신 쓰기 호출에서 직접 데이터를 처리할 수 있으며 쓰기 호출을 사용하여 새 데이터를 사용할 수 있음을 나타낼 수 있습니다.

요구 사항

추가 정보

ISequentialStream 인터페이스

IXMLHTTPRequest2Callback