IWinHttpRequest::SetCredentials 메서드
SetCredentials 메서드는 프록시 서버이든 원래 서버이든 HTTP 서버와 함께 사용할 자격 증명을 설정합니다.
구문
HRESULT SetCredentials(
[in] BSTR UserName,
[in] BSTR Password,
[in] HTTPREQUEST_SETCREDENTIALS_FLAGS Flags
);
매개 변수
-
UserName [in]
-
인증의 사용자 이름을 지정합니다.
-
암호 [in]
-
인증의 암호를 지정합니다. bstrUserName이 NULL이거나 누락된 경우 이 매개 변수는 무시됩니다.
-
Flags [in]
-
IWinHttpRequest에서 자격 증명을 사용하는 시기를 지정합니다. 다음 값 중 하나일 수 있습니다.
값 의미 - HTTPREQUEST_SETCREDENTIALS_FOR_SERVER
자격 증명은 서버에 전달됩니다. - HTTPREQUEST_SETCREDENTIALS_FOR_PROXY
자격 증명은 프록시에 전달됩니다.
반환 값
반환 값은 성공에 S_OK , 그렇지 않으면 오류 값입니다.
설명
Open에 대한 호출이 성공적으로 완료되지 않은 경우 이 메서드는 오류 값을 반환합니다. 사용자가 세션에 대한 자격 증명을 설정하기 전에 프록시 서버 또는 원본 서버와의 상호 작용에 대한 일부 측정값이 발생해야 한다고 가정합니다. 또한 사용자가 지원되는 인증 체계를 알 때까지 자격 증명의 형식을 지정할 수 없습니다.
참고
Windows XP 및 Windows 2000의 경우 WinHTTP 시작 페이지의 런타임 요구 사항 섹션을 참조하세요.
서버와 프록시를 모두 사용하여 인증하려면 애플리케이션이 SetCredentials를 두 번 호출해야 합니다. 먼저 Flags 매개 변수를 HTTPREQUEST_SETCREDENTIALS_FOR_SERVER 로 설정하고, 두 번째 매개 변수를HTTPREQUEST_SETCREDENTIALS_FOR_PROXY.
예제
다음 예제에서는 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 Credentials.
BSTR bstrUserName = SysAllocString(L"User Name");
BSTR bstrPassword = SysAllocString(L"Password");
hr = pIWinHttpRequest->SetCredentials(
bstrUserName,
bstrPassword,
HTTPREQUEST_SETCREDENTIALS_FOR_SERVER);
SysFreeString(bstrUserName);
SysFreeString(bstrPassword);
}
if (SUCCEEDED(hr))
{ // Send Request.
hr = pIWinHttpRequest->Send(varEmpty);
}
if (SUCCEEDED(hr))
{ // Get Response text.
hr = pIWinHttpRequest->get_ResponseText(&bstrResponse);
}
if (SUCCEEDED(hr))
{ // Print response to console.
wprintf(L"%.256s",bstrResponse);
}
// Release memory.
if (pIWinHttpRequest)
pIWinHttpRequest->Release();
if (bstrResponse)
SysFreeString(bstrResponse);
CoUninitialize();
return 0;
}
다음 스크립팅 예제에서는 HTTP 연결을 열고, 서버에 대한 자격 증명을 설정하고, 프록시를 사용하는 경우 자격 증명을 설정하고, HTTP 요청을 보내고, 응답 텍스트를 읽는 방법을 보여줍니다.
// HttpRequest SetCredentials flags
HTTPREQUEST_SETCREDENTIALS_FOR_SERVER = 0;
HTTPREQUEST_SETCREDENTIALS_FOR_PROXY = 1;
// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");
// Specify the target resource.
var targURL = "https://msdn.microsoft.com/downloads/samples/"+
"internet/winhttp/auth/authenticate.asp";
WinHttpReq.open("GET", targURL, false);
var Done = false;
var LastStatus=0;
do {
// Send a request to the server and wait for a response.
WinHttpReq.send();
// Obtain the status code from the response.
var Status = WinHttpReq.Status;
switch (Status){
// A 200 status indicates that the resource was retrieved.
case 200:
Done = true;
break;
// A 401 status indicates that the server
// requires authentication.
case 401:
WScript.Echo("Requires Server UserName and Password.");
// Specify the target resource.
WinHttpReq.open("GET", targURL, false);
// Set credentials for the server.
WinHttpReq.SetCredentials("User Name", "Password",
HTTPREQUEST_SETCREDENTIALS_FOR_SERVER);
// If the same credentials are requested twice, abort
// the request. For simplicity, this sample does not
// check for a repeated sequence of status codes.
if (LastStatus==401)
Done = true;
break;
// A 407 status indicates that the proxy
// requires authentication.
case 407:
WScript.Echo("Requires Proxy UserName and Password.");
// Specify the target resource.
WinHttpReq.open("GET", targURL, false);
// Set credentials for the proxy.
WinHttpReq.SetCredentials("User Name", "Password",
HTTPREQUEST_SETCREDENTIALS_FOR_PROXY);
// If the same credentials are requested twice, abort
// the request. For simplicity, this sample does not
// check for a repeated sequence of status codes.
if (LastStatus==407)
Done = true;
break;
// Any other status is unexpected.
default:
WScript.Echo("Unexpected Status: "+Status);
Done = true;
break;
}
// Keep track of the last status code.
LastStatus = Status;
} while (!Done);
// Display the results of the request.
WScript.Echo(WinHttpReq.Status + " " + WinHttpReq.StatusText);
WScript.Echo(WinHttpReq.GetAllResponseHeaders());
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP, Windows 2000 Professional SP3 포함 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당] |
| 재배포 가능 파일 |
Windows XP 및 Windows 2000에서 WinHTTP 5.0 및 인터넷 Explorer 5.01 이상. |
| IDL |
|
| 라이브러리 |
|
| DLL |
|