IXMLHTTPRequest2::SetProperty メソッド (msxml6.h)

  • [アーティクル]

送信 HTTP 要求のプロパティを設定します。

構文

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

パラメーター

[in] eProperty

有効な値は、次のとおりです。

値 意味
XHR_PROP_NO_CRED_PROMPT
 ユーザー資格情報の自動プロンプトを抑制します
XHR_PROP_NO_AUTH
 アプリケーションに代わって HTTP スタックが実行する認証を抑制します
XHR_PROP_TIMEOUT
 すべてのタイムアウト値を 、ullValue によって指定された値 (ミリ秒単位) に設定します。
XHR_PROP_NO_DEFAULT_HEADERS
 HTTP 要求への既定のヘッダーの追加を抑制します。
XHR_PROP_REPORT_REDIRECT_STATUS
 HTTP スタックで、中間リダイレクト状態コードを使用して OnHeadersAvailable メソッドを呼び出します。 OnHeadersAvailable メソッドは、追加のリダイレクトと最終的な宛先状態コードのために再度呼び出されます。
XHR_PROP_NO_CACHE
 HTTP 要求のキャッシュ読み取りと書き込みを抑制します。

このプロパティは、 IXMLHTTPRequest3 インターフェイスでサポートされています。
XHR_PROP_EXTENDED_ERROR
 エラーが発生した場合に、HTTP スタックが基になる Win32 エラー コードを ONError メソッドに HRESULTS に提供します。

このプロパティは、 IXMLHTTPRequest3 インターフェイスでサポートされています。
XHR_PROP_QUERY_STRING_UTF8
HTTP 要求の ACP ではなく UTF-8 でクエリ文字列をエンコードします。

このプロパティは、 IXMLHTTPRequest3 インターフェイスでサポートされています。
XHR_PROP_IGNORE_CERT_ERRORS
 特定の証明書エラーを抑制します。

このプロパティは、 IXMLHTTPRequest3 インターフェイスでサポートされています。

[in] ullValue

アプリケーションがタイムアウトするまで待機するミリ秒数を指定します。

値 意味
XHR_PROP_NO_CRED_PROMPT
 このパラメーターには、Msxml6.h ヘッダー ファイルで定義されているXHR_CRED_PROMPT列挙型の値のいずれかを指定できます。
  • 資格情報 のプロンプトを有効にする必要があるかどうかをXHR_CRED_PROMPT_ALL します (既定値)。
  • 資格情報 のプロンプトを無効にする必要があるかどうかをXHR_CRED_PROMPT_NONEします。
  • 資格情報 のプロンプトをプロキシ認証のみを有効にする必要がある場合は、XHR_CRED_PROMPT_PROXYします。
XHR_PROP_NO_AUTH
 このパラメーターには、Msxml6.h ヘッダー ファイルで定義されているXHR_AUTH列挙型の値のいずれかを指定できます。
  • 認証が有効になっている場合にXHR_AUTH_ALLします (既定値)。
  • 認証が無効になっている場合は、XHR_AUTH_NONEします。
  • 認証 をプロキシ認証でのみ有効にする必要がある場合は、XHR_AUTH_PROXYします。
XHR_PROP_TIMEOUT
アプリがタイムアウトするまでに待機する最大0xFFFFFFFFミリ秒。
XHR_PROP_NO_DEFAULT_HEADERS
  • 既定のヘッダー (既定値) の追加を有効にする FALSE (0x0)。
  • 既定のヘッダーの追加を無効にする場合は TRUE(0x1)。
XHR_PROP_REPORT_REDIRECT_STATUS
  • リダイレクトの状態を報告しない FALSE(0x0) (既定値)。
  • リダイレクトの状態を報告する TRUE(0x1)。
XHR_PROP_NO_CACHE
  • キャッシュを有効にする FALSE(0x0) (既定値)。
  • キャッシュを無効にする場合は TRUE(0x1)。
XHR_PROP_EXTENDED_ERROR
  • 拡張エラーを提供しない場合は FALSE(0x0) (既定値)。
  • TRUE(0x1) 拡張エラーを提供します。
XHR_PROP_QUERY_STRING_UTF8
  • クエリ文字列を UTF-8 (既定値) でエンコードしない場合は FALSE (0x0)。
  • クエリ文字列を UTF-8 でエンコードする TRUE(0x1)。
XHR_PROP_IGNORE_CERT_ERRORS
  • 証明書エラーを無視しない FALSE(0x0) (既定値)。
  • 証明書エラーを無視する場合は TRUE(0x1)。

戻り値

成功すると S_OK を返します。

注釈

IXMLHTTPRequest2 インターフェイスの SetProperty メソッドは、新しいシナリオをサポートするために、新しいプロパティを使用して IXMLHTTPRequest3 インターフェイスで拡張されます。

  • XHR_PROP_NO_CACHE – HTTP 要求のキャッシュの読み取りと書き込みを抑制します。
  • XHR_PROP_EXTENDED_ERROR – エラーが発生した場合に、基になる Win32 エラー コードを ONError メソッドに対して HRESULTS が HTTP スタックに提供します。
  • XHR_PROP_QUERY_STRING_UTF8 – クエリ文字列が HTTP 要求用の ACP ではなく UTF-8 でエンコードされます。
  • XHR_PROP_IGNORE_CERT_ERRORS – 特定のサーバー証明書エラーを抑制します。

要件

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

こちらもご覧ください

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

[ファイル]

XHR_PROPERTY 列挙