IBITSExtensionSetupFactory

IBITSExtensionSetupFactory インターフェイスは、IBITSExtensionSetup インターフェイスへのポインターを取得するために使用します。

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

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

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

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