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

[アーティクル]
03/05/2024

送信 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