WinHttpRequest 개체

  • 아티클

이 항목에서는 스크립팅 언어와 함께 WinHTTP WinHttpRequest COM 개체를 사용하는 방법에 대한 정보를 제공합니다. C++ API(WinHTTP)를 비롯한 자세한 내용은 WinHTTP 정보를 참조하세요. 이러한 인터페이스를 비교하려면 WinHTTP 인터페이스 선택을 참조하세요.

예제

// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");

 IWinHttpRequest *  pIWinHttpRequest = NULL;
 \\..
    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }

IWinHttpRequest::Status 속성에서 가져온 코드 예제입니다.

멤버

WinHttpRequest 개체에는 다음과 같은 유형의 멤버가 있습니다.

이벤트

WinHttpRequest 개체에는 이러한 이벤트가 있습니다.

이벤트 Description
OnError 애플리케이션에 런타임 오류가 있을 때 발생합니다.
OnResponseDataAvailable 응답에서 데이터를 사용할 수 있을 때 발생합니다.
OnResponseFinished 응답 데이터가 완료되면 발생합니다.
OnResponseStart 응답 데이터가 수신되기 시작할 때 발생합니다.

메서드

WinHttpRequest 개체에는 이러한 메서드가 있습니다.

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

속성

WinHttpRequest 개체에는 이러한 속성이 있습니다.

속성 액세스 유형 설명
옵션
 읽기/쓰기
 WinHTTP 옵션 값을 설정하거나 검색합니다.
ResponseBody
 읽기 전용
 응답 엔터티 본문을 부호 없는 바이트의 배열로 검색합니다.
ResponseStream
 읽기 전용
 응답 엔터티 본문을 IStream으로 검색합니다.
ResponseText
 읽기 전용
 응답 엔터티 본문을 텍스트로 검색합니다.
상태
 읽기 전용
 마지막 응답에서 HTTP 상태 코드를 검색합니다.
StatusText
 읽기 전용
 HTTP 상태 텍스트를 검색합니다.

설명

WinHttpRequest 개체는 IErrorInfo 인터페이스를 사용하여 오류 데이터를 제공합니다. 설명 및 숫자 오류 값은 Microsoft VBScript(Visual Basic Scripting Edition)의 Err 개체와 Microsoft JScript의 Error 개체를 사용하여 가져올 수 있습니다. 오류 번호의 하위 16비트 는 오류 메시지에 있는 값에 해당합니다.

참고

Windows XP 및 Windows 2000의 경우 런타임 요구 사항을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 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

추가 정보

WinHTTP 버전