IWinHttpRequest::SetRequestHeader 메서드

SetRequestHeader 메서드는 HTTP 요청 헤더를 추가, 변경 또는 삭제합니다.

구문

HRESULT SetRequestHeader(
  [in] BSTR Header,
  [in] BSTR Value
);

매개 변수

헤더 [in]

설정할 헤더의 이름(예: "depth")을 지정합니다. 이 매개 변수는 콜론을 포함하지 않아야 하며 HTTP 헤더의 실제 텍스트여야 합니다.

값 [in]

헤더의 값(예: "무한대")을 지정합니다.

반환 값

반환 값은 성공에 S_OK 오류 값이 아닌 경우입니다.

설명

헤더는 리디렉션 간에 전송됩니다. 이렇게 하면 보안 취약성이 발생할 수 있습니다. 리디렉션이 발생하는 경우 헤더가 전송되지 않도록 하려면 WINHTTP_STATUS_CALLBACK 콜백을 사용하여 리디렉션이 발생할 때 특정 헤더를 수정합니다.

SetRequestHeader 메서드를 사용하면 호출 애플리케이션이 요청을 보내기 전에 HTTP 요청 헤더를 추가하거나 삭제할 수 있습니다. 헤더 이름은 헤더에 지정되고 헤더 토큰 또는 값은 Value에 지정됩니다. 헤더를 추가하려면 헤더 이름과 값을 입력합니다. 이 이름을 가진 다른 헤더가 이미 있는 경우 대체됩니다. 헤더를 삭제하려면 헤더 를 헤더 이름으로 설정하여 삭제하고 값을NULL로 설정합니다.

이 메서드를 사용하여 추가된 요청 헤더의 이름과 값의 유효성이 검사됩니다. 헤더는 잘 구성되어야 합니다. 유효한 HTTP 헤더에 대한 자세한 내용은 RFC 2616을 참조하세요. 잘못된 헤더를 사용하면 오류가 발생하고 헤더가 추가되지 않습니다.

예제

다음 예제에서는 HTTP 연결을 열고, 요청 헤더를 설정하고, HTTP 요청을 보내고, 응답 텍스트를 읽는 방법을 보여줍니다. 이 예제는 명령 프롬프트에서 실행해야 합니다.

#include <windows.h>
#include <stdio.h>
#include <objbase.h>

#include "httprequest.h"

#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "oleaut32.lib")

// IID for IWinHttpRequest.
const IID IID_IWinHttpRequest =
{
  0x06f29373,
  0x5c5a,
  0x4b54,
  {0xb0, 0x25, 0x6e, 0xf1, 0xbf, 0x8a, 0xbf, 0x0e}
};

int main()
{
    // Variable for return value
    HRESULT    hr;

    // Initialize COM.
    hr = CoInitialize( NULL );

    IWinHttpRequest *  pIWinHttpRequest = NULL;

    BSTR            bstrResponse = NULL;
    VARIANT         varFalse;
    VARIANT         varEmpty;

    CLSID           clsid;

    VariantInit(&varFalse);
    V_VT(&varFalse)   = VT_BOOL;
    V_BOOL(&varFalse) = VARIANT_FALSE;

    VariantInit(&varEmpty);
    V_VT(&varEmpty) = VT_ERROR;

    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }
    if (SUCCEEDED(hr))
    {    // Open WinHttpRequest.
        BSTR bstrMethod  = SysAllocString(L"GET");
        BSTR bstrUrl = SysAllocString(L"https://microsoft.com");
        hr = pIWinHttpRequest->Open(bstrMethod, bstrUrl, varFalse);
        SysFreeString(bstrMethod);
        SysFreeString(bstrUrl);
    }
    if (SUCCEEDED(hr))
    {    // Set request header.
        BSTR bstrName  = SysAllocString(L"Date");
        BSTR bstrValue = SysAllocString(L"Fri, 16 Mar 2001 00:25:54 GMT");
        hr = pIWinHttpRequest->SetRequestHeader(bstrName, bstrValue);
        SysFreeString(bstrName);
        SysFreeString(bstrValue);
    }
    if (SUCCEEDED(hr))
    {    // Send Request.
        hr = pIWinHttpRequest->Send(varEmpty);
    }
    if (SUCCEEDED(hr))
    {    // Get Response headers.
        hr = pIWinHttpRequest->GetAllResponseHeaders(&bstrResponse);
    }
    if (SUCCEEDED(hr))
    {    // Print the response to a console.
        wprintf(L"%.256s",bstrResponse);
    }

    // Release memory.
    if (pIWinHttpRequest)
        pIWinHttpRequest->Release();
    if (bstrResponse)
        SysFreeString(bstrResponse);

    CoUninitialize();
    return 0;
}

다음 스크립팅 예제에서는 HTTP 연결을 열고, 요청 헤더를 설정하고, HTTP 요청을 보내는 방법을 보여줍니다.

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

// Initialize an HTTP request.  
WinHttpReq.Open("GET", "https://www.microsoft.com", false);

// Add/replace a request header.
WinHttpReq.SetRequestHeader("Date", Date());

// Send the HTTP request.
WinHttpReq.Send();

요구 사항

추가 정보

IWinHttpRequest

WinHttpRequest

WinHTTP 버전