IBITSExtensionSetup

IBITSExtensionSetup インターフェイスを使用して、仮想ディレクトリへの BITS アップロードを有効または無効にします。

このインターフェイスは、BITS サーバー拡張機能をインストールしたときにサーバーに登録されます。

Windows Server 2003 では、Windows コンポーネント ウィザードを使用して BITS サーバー拡張機能をインストールします。コントロール パネルからプログラムの追加と削除を選択し、次に Windows コンポーネントの追加と削除を選択して Windows コンポーネント ウィザードを表示します。BITS サーバー拡張機能は、Web アプリケーション サーバーのサブコンポーネントである Internet Information Services (IIS) のサブコンポーネントです。

例

次の例は、ADsGetObject 関数を使用して IBITSExtensionSetup インターフェイスへのポインターを取得する方法を示しています。

//Set the BITSUploadEnabled IIS configuration setting.
//The pszPath parameter contains the path to the directory service. 
//For example, "IIS://<machine name>/w3svc/1/<virtual directory>".
//The Enable parameter contains true (enable) or false (disable).
HRESULT SetBITSUploadEnabledSetting(LPWSTR pszPath, bool Enable)
{
  HRESULT hr;
  IBITSExtensionSetup* pExtensionSetup = NULL;

  hr = ADsGetObject(pszPath, __uuidof(IBITSExtensionSetup), &pExtensionSetup);
  if (SUCCEEDED(hr))
  {
    if (Enable)
    {
      hr = pExtensionSetup->EnableBITSUploads();
    }
    else
    {
      hr = pExtensionSetup->DisableBITSUploads();
    }

    pExtensionSetup->Release();
  }

  return hr;
}

EnableBITSUploads メソッドを使用して、ADSI オブジェクトが指す仮想ディレクトリで BITS アップロードを有効にします。このメソッドは BITSUploadEnabled IIS 拡張プロパティを設定します。

成功した場合、このメソッドは S_OK を返します。それ以外の場合は、メソッドが失敗したことを示します。

このメソッドは、仮想ディレクトリのスクリプトおよび実行の権限を無効にします。スクリプトおよび実行の権限が有効になっている仮想ディレクトリには、ファイルをアップロードできません。このメソッドの呼び出し後にこれらの権限が復元された場合、アップロードジョブは BG_E_SERVER_EXECUTE_ENABLED エラーコードで失敗します。

タスク スケジューラが無効になっている場合、 EnableBITSUploads メソッドは失敗します。

例

IBITSExtensionSetup インターフェイスの例を参照してください。

DisableBITSUploads メソッドを使用して、ADSI オブジェクトが指す仮想ディレクトリで BITS アップロードを無効にします。このメソッドは BITSUploadEnabled IIS 拡張プロパティを設定します。

成功した場合、このメソッドは S_OK を返します。それ以外の場合は、メソッドが失敗したことを示します。

GetCleanupTaskName メソッドを使用して、仮想ディレクトリに関連付けられているクリーンアップタスクの名前を取得します。

成功した場合、このメソッドは S_OK を返します。仮想ディレクトリにタスク名が指定されていない場合は、S_FALSE を返します。

仮想ディレクトリを作成し、BITS アップロード用に有効化すると、BITS は タスク スケジューラに作業項目を追加します。この作業項目は、タイムアウト期間内に変更されていないジョブを削除することで、12 時間ごとに 1 回、仮想ディレクトリをクリーンアップします。タイムアウト期間を指定するには、 BITSSessionTimeout IIS 拡張プロパティを設定します。

pTaskName の名前は Schtasks.exe 実行可能ファイルの入力パラメーターとして使用でき、これによりスクリプトからクリーンアップタスクのプロパティを変更できます。

GetCleanupTask メソッドを使用して、仮想ディレクトリに関連付けられているクリーンアップタスクへのインターフェイスポインターを取得します。

成功した場合、このメソッドは S_OK を返します。仮想ディレクトリにタスクが作成されていない場合は、S_FALSE を返します。

仮想ディレクトリを作成し、BITS アップロード用に有効化すると、BITS は タスク スケジューラに作業項目を追加します。この作業項目は、タイムアウト期間内に変更されていないジョブを削除することで、12 時間ごとに 1 回、仮想ディレクトリをクリーンアップします。タイムアウト期間を指定するには、 BITSSessionTimeout IIS 拡張プロパティを設定します。

クリーンアップのスケジュールを変更するには、BITSCleanupUseDefault BITS IIS 拡張プロパティを参照してください。