IWinHttpRequest::SetClientCertificate 메서드

  • 아티클

SetClientCertificate 메서드는 HTTPS(보안 하이퍼텍스트 전송 프로토콜) 서버로 보낼 클라이언트 인증서를 선택합니다.

구문

HRESULT SetClientCertificate(
  [in] BSTR ClientCertificate
);

매개 변수

ClientCertificate [in]

클라이언트 인증서의 위치, 인증서 저장소 및 주체를 지정합니다.

반환 값

반환 값은 성공에 S_OK , 그렇지 않으면 오류 값입니다.

설명

ClientCertificate 매개 변수에 지정된 문자열은 인증서 위치, 인증서 저장소 및 백슬라이시로 구분된 주체 이름으로 구성됩니다. 인증서 문자열의 구성 요소에 대한 자세한 내용은 클라이언트 인증서를 참조하세요.

인증서 저장소 이름 및 위치는 선택 사항입니다. 그러나 인증서 저장소를 지정하는 경우 해당 인증서 저장소의 위치도 지정해야 합니다. 기본 위치는 CURRENT_USER 기본 인증서 저장소는 "MY"입니다. 빈 주체는 인증서 저장소의 첫 번째 인증서를 사용해야 임을 나타냅니다.

SetClientCertificate를 호출하여 보내기를 호출하여 요청을 보내기 전에 인증서를 선택합니다.

Microsoft WinHTTP(Windows HTTP 서비스)는 인증을 위해 인증서를 요청하는 프록시 서버에 클라이언트 인증서를 제공하지 않습니다.

참고

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

예제

다음 스크립팅 예제에서는 요청과 함께 보낼 클라이언트 인증서를 선택하는 방법을 보여줍니다. "내 Middle-Tier 인증서"라는 제목의 인증서는 HKEY_LOCAL_MACHINE 레지스트리의 "개인" 인증서 저장소에서 선택됩니다. 이 코드 예제는 백슬래시를 이스케이프 문자로 사용하는 Microsoft JScript에만 해당되므로 인증서 문자열의 구성 요소를 구분하려면 인접한 두 개의 백슬래시가 필요합니다.

// Instantiate a WinHttpRequest object.
var HttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
    
// Open an HTTP connection.
HttpReq.Open("GET", "https://www.fabrikam.com/", false);
    
// Select a client certificate.
HttpReq.SetClientCertificate(
            "LOCAL_MACHINE\\Personal\\My Middle-Tier Certificate");

// Send the HTTP Request.
HttpReq.Send();

요구 사항

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

추가 정보

IWinHttpRequest

WinHttpRequest

WinHTTP의 SSL

WinHTTP 버전