IWinHttpRequest 인터페이스

  • 아티클

IWinHttpRequest 인터페이스는 WinHTTP(Microsoft Windows HTTP 서비스)에 대한 모든 nonevent 메서드를 제공합니다.

멤버

IWinHttpRequest 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IWinHttpRequest 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IWinHttpRequest 인터페이스에는 이러한 메서드가 있습니다.

메서드 설명
중단 WinHTTPSend 메서드를 중단합니다.
GetAllResponseHeaders 모든 HTTP 응답 헤더를 검색합니다.
GetResponseHeader HTTP 응답 헤더를 검색합니다.
열기 HTTP 리소스에 대한 HTTP 연결을 엽니다.
Send HTTP 서버에 HTTP 요청을 보냅니다.
SetAutoLogonPolicy 현재 자동 로그온 정책을 설정합니다.
SetClientCertificate HTTPS(보안 하이퍼텍스트 전송 프로토콜) 서버로 보낼 클라이언트 인증서를 선택합니다.
SetCredentials HTTP 서버(프록시 서버 또는 원래 서버)와 함께 사용할 자격 증명을 설정합니다.
SetProxy 프록시 서버 정보를 설정합니다.
SetRequestHeader HTTP 요청 헤더를 추가, 변경 또는 삭제합니다.
SetTimeouts 송신/수신 작업의 개별 제한 시간 구성 요소를 밀리초 단위로 지정합니다.
WaitForResponse 선택적 제한 시간 값(초)을 사용하여 비동기 Send 메서드가 완료되기를 기다립니다.

속성

IWinHttpRequest 인터페이스에는 이러한 속성이 있습니다.

속성 액세스 유형 설명
옵션
 읽기/쓰기
 WinHTTP 옵션 값입니다.
ResponseBody
 읽기 전용
 부호 없는 바이트의 배열로 응답 엔터티 본문입니다.
ResponseStream
 읽기 전용
 IStream인 응답 엔터티 본문입니다.
ResponseText
 읽기 전용
 응답 엔터티 본문입니다.
상태
 읽기 전용
 마지막 응답의 HTTP 상태 코드입니다.
StatusText
 읽기 전용
 HTTP 상태 텍스트입니다.

설명

httprequest.idl에 정의된 IWinHttpRequest 인터페이스는 id가 CLSID_WinHttpRequest 클래스에 의해 구현됩니다. 애플리케이션은 클래스 ID가 CLSID_WinHttpRequest 및 인터페이스 ID가 IID_IWinHttpRequestCoCreateInstance를 호출하여 이 인터페이스를 가져옵니다.

참고

Windows XP 및 Windows 2000의 경우 WinHttp 시작 페이지의 런타임 요구 사항 섹션을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP, Windows 2000 Professional SP3 포함 [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당]
재배포 가능 파일
 Windows XP 및 Windows 2000에서 WinHTTP 5.0 및 인터넷 Explorer 5.01 이상.
IDL
HttpRequest.idl
라이브러리
Winhttp.lib
DLL
Winhttp.dll

추가 정보

IWinHttpRequestEvents

WinHTTP 버전