IXMLHTTPRequest2::Open 메서드(msxml6.h)

IXMLHTTPRequest2 요청을 초기화하고 요청에 대한 메서드, URL 및 인증 정보를 지정합니다. 이 메서드를 호출한 후에 는 Send 메서드를 호출하여 요청 및 데이터(있는 경우)를 서버에 보내야 합니다.

구문

HRESULT Open(
  [in]           const WCHAR              *pwszMethod,
  [in]           const WCHAR              *pwszUrl,
  [in, optional] IXMLHTTPRequest2Callback *pStatusCallback,
  [in, optional] const WCHAR              *pwszUserName,
  [in, optional] const WCHAR              *pwszPassword,
  [in, optional] const WCHAR              *pwszProxyUserName,
  [in, optional] const WCHAR              *pwszProxyPassword
);

매개 변수

[in] pwszMethod

연결을 여는 데 사용되는 HTTP 메서드(예: GET 또는 POST)입니다. XMLHTTP의 경우 이 매개 변수는 대/소문자를 구분하지 않습니다.

[in] pwszUrl

요청된 URL입니다. 절대 URL(예: ";)http://Myserver/Mypath/Myfile.asp"이어야 합니다.

[in, optional] pStatusCallback

콜백 이벤트를 수신하는 앱에서 구현하는 콜백 인터페이스입니다.

Send 메서드가 성공하면 이 인터페이스의 메서드가 호출되어 응답 또는 기타 이벤트를 처리합니다.

[in, optional] pwszUserName

인증에 대한 사용자의 이름입니다. 이 매개 변수가 Null이고 사이트에 인증이 필요한 경우 SetProperty에서 사용하지 않도록 설정하지 않는 한 로그온 UI 표시를 포함하여 Windows에서 자격 증명을 관리합니다.

[in, optional] pwszPassword

인증을 위한 암호입니다. pwszUserName 매개 변수가 Null이거나 누락된 경우 이 매개 변수는 무시됩니다.

[in, optional] pwszProxyUserName

프록시 서버에서 인증할 사용자의 이름입니다. 이 매개 변수가 Null 또는 빈 문자열이고 사이트에 인증이 필요한 경우 SetProperty에서 사용하지 않도록 설정하지 않는 한 로그온 UI 표시를 포함하여 Windows에서 자격 증명을 관리합니다.

[in, optional] pwszProxyPassword

프록시 서버에서 인증을 위한 암호입니다. pwszProxyUserName 매개 변수가 Null이거나 누락된 경우 이 매개 변수는 무시됩니다.

반환 값

성공하면 S_OK를 반환합니다.

설명

이 메서드는 매개 변수를 통해 전달된 자격 증명을 수락하지만 이러한 자격 증명은 첫 번째 요청에서 서버로 자동으로 전송되지 않습니다. pwszUserName 및 pwszPassword 매개 변수는 서버가 401 - 권한 없는 응답을 사용하여 클라이언트에 자격 증명에 대해 이의를 제기하지 않는 한 서버로 전송되지 않습니다.

예제

//
// Create and initialize an IXMLHTTPRequest2 object
//
hr = CoCreateInstance(CLSID_FreeThreadedXMLHTTP60,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_PPV_ARGS(&spXHR));

//
//Create and initialize an IXMLHTTPRequest2Callback object
//
hr = MakeAndInitialize<CXMLHttpRequest2Callback>(&spXhrCallback);

hr = spXHR->Open(L"GET",              // Method.
                 pcwszUrl,            // Url.
                 spXhrCallback.Get(), // Callback.
                 NULL,                // Username.
                 NULL,                // Password.
                 NULL,                // Proxy username.
                 NULL);               // Proxy password.

//
//Send the GET request
//
hr = spXHR->Send(NULL, 0);

hr = spXhrCallback->WaitForComplete(&dwStatus);

전체 예제는 XML HTTP 요청 2 GET 샘플 및 XML HTTP 요청 2 POST 샘플을 참조하세요.

요구 사항

추가 정보

IXMLHTTPRequest2

IXMLHTTPRequest2Callback 인터페이스

Send 메서드