IBITSExtensionSetup インターフェイス (bitscfg.h)

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

このインターフェイスは ADSI 拡張機能です。 このインターフェイスへのポインターを取得するには、「コード例」に示すように 、ADsGetObject ADSI 関数を呼び出します。

BITS サーバーもインストールするセットアップ プログラムからこのインターフェイスを使用する場合は、 IBITSExtensionSetupFactory::GetObject メソッドを呼び出して 、ADsGetObject 関数を呼び出す代わりにこのインターフェイスへのポインターを取得する必要があります。

継承

IBITSExtensionSetup インターフェイスは、IUnknown インターフェイスから継承されます。 IBITSExtensionSetup には、次の種類のメンバーもあります。

メソッド

IBITSExtensionSetup インターフェイスには、これらのメソッドがあります。

IBITSExtensionSetup::D isableBITSUploads DISABLEBITSUploads メソッドを使用して、ADSI オブジェクトが指す仮想ディレクトリでの BITS アップロードを無効にします。 このメソッドは、BITSUploadEnabled IIS 拡張プロパティを設定します。
IBITSExtensionSetup::EnableBITSUploads ENABLEBITSUploads メソッドを使用して、ADSI オブジェクトが指す仮想ディレクトリで BITS アップロードを有効にします。 このメソッドは、BITSUploadEnabled IIS 拡張プロパティを設定します。
IBITSExtensionSetup::GetCleanupTask GetCleanupTask メソッドを使用して、仮想ディレクトリに関連付けられているクリーンアップ タスクへのインターフェイス ポインターを取得します。
IBITSExtensionSetup::GetCleanupTaskName GetCleanupTaskName メソッドを使用して、仮想ディレクトリに関連付けられているクリーンアップ タスクの名前を取得します。

注釈

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

Windows Server 2003 では、 Windows コンポーネント ウィザード を使用して BITS サーバー拡張機能をインストールします。 コントロール パネルから、[プログラムの追加と削除] を選択します。 次に、[ Windows コンポーネントの追加と削除 ] を選択して 、Windows コンポーネント ウィザードを表示します。 BITS サーバー拡張機能は、Web アプリケーション サーバーのサブコンポーネントであるインターネット インフォメーション サービス (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;
}

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2003
対象プラットフォーム	Windows
ヘッダー	bitscfg.h
再頒布可能パッケージ	Windows XP の BITS 1.5

こちらもご覧ください

IBITSExtensionSetupFactory