Share via

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。 これは、"http://Myserver/Mypath/Myfile.asp" などの絶対 URL である必要があります。

[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 - Unauthorized 応答でクライアントに資格情報を要求しない限り、サーバーに送信されません。

例

//
// 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 サンプルを参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ],MSXML 6.0 以降
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー msxml6.h

こちらもご覧ください

IXMLHTTPRequest2

IXMLHTTPRequest2Callback インターフェイス

Send メソッド