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

IBITSExtensionSetupFactory インターフェイスを使用して、IBITSExtensionSetup インターフェイスへのポインターを取得します。 このインターフェイスは、BITS サーバーもインストールするセットアップ プログラムで IBITSExtensionSetup インターフェイスを使用する場合にのみ使用します。 IIS キャッシュにはセットアップ中に追加された BITS 拡張機能が含まれていないため、 拡張機能は ADsGetObject ADSI 関数を使用して使用できません。 IBITSExtensionSetupFactory インターフェイスは、BITS 拡張機能にアクセスし、ADsGetObject 関数と同じバインドを実行する GetObject メソッドを提供します。

IBITSExtensionSetupFactory インターフェイスへのポインターを取得するには、「コード例」に示すように CoCreateInstance 関数を呼び出します。

継承

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

メソッド

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

IBITSExtensionSetupFactory::GetObject GetObject メソッドを使用して、IBITSExtensionSetup インターフェイスへのポインターを取得します。 このメソッドは、ADsGetObject ADSI 関数が実行するのと同じバインドを実行します。

注釈

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

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

例

次の例は、 IBITSExtensionSetupFactory インターフェイスを使用して 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;
  IBITSExtensionSetupFactory* pExtensionSetupFactory = NULL;
  IBITSExtensionSetup* pExtensionSetup = NULL;

  hr = CoCreateInstance(__uuidof(BITSExtensionSetupFactory),
    NULL, CLSCTX_INPROC_SERVER,
    __UUIDOF(IBITSExtensionSetupFactory),
    (void**)&pExtensionSetupFactory);

  if (SUCCEEDED(hr))
  {
    hr = pExtensionSetupFactory->GetObject(BSTR(pszPath), &pExtensionSetup);
    if (SUCCEEDED(hr))
    {
      if (Enable)
      {
        hr = pExtensionSetup->EnableBITSUploads();
      }
      else
      {
        hr = pExtensionSetup->DisableBITSUploads();
      }

      pExtensionSetup->Release();
    }
    pExtensionSetupFactory->Release();
  }

  return hr;
}

要件

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

こちらもご覧ください

IBITSExtensionSetup