IBackgroundCopyJobHttpOptions2::SetHttpMethod メソッド (bits10_2.h)

BITS 転送に使用される既定の HTTP メソッドをオーバーライドします。

構文

HRESULT SetHttpMethod(
  [in] LPCWSTR method
);

パラメーター

[in] method

種類: LPCWSTR

HTTP メソッド名を含むワイド文字の定数 null で終わる文字列へのポインター。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

BITS を使用すると、開発者は既定のメソッド以外の HTTP メソッドを選択できます。 これにより、HTTP サーバーの通常の BITS 要件に準拠していないサーバーと対話する BITS の機能が向上します。 既定の HTTP メソッドとは異なる HTTP メソッドを選択する場合は、次の点に注意してください。

• BITS はジョブの優先度を自動的に BG_JOB_PRIORITY_FOREGROUNDに変更し、その優先度が変更されないようにします。
• 通常再開可能なエラー (接続の喪失など) は、ジョブを ERROR 状態に移行します。 開発者は、 IBackgroundCopyJob::Resume を呼び出してジョブを再起動でき、ジョブは最初から再起動されます。 BITS ジョブの状態の詳細については、「BITS ジョブのライフ サイクル」を参照してください。
• BITS では 、SetHttpMethod を使用したDYNAMIC_CONTENTジョブやON_DEMAND_MODE ジョブは許可されません。

渡すメソッド名が転送の種類の既定の HTTP メソッドと一致する場合、SetHttpMethod は何も行いません。 たとえば、ダウンロード ジョブメソッドを "GET" (既定値) に設定した場合、ジョブの優先度は変更されません。 ジョブを開始する IBackgroundCopyJob::Resume を最初に呼び出す前に、HTTP メソッドを設定する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 10 Version 1809 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	bits10_2.h (Bits.h を含む)
Library	Bits.lib

こちらもご覧ください

IBackgroundCopyJobHttpOptions2