IBITSExtensionSetupFactory-Schnittstelle (bitscfg.h)

Verwenden Sie die IBITSExtensionSetupFactory-Schnittstelle , um einen Zeiger auf die IBITSExtensionSetup-Schnittstelle abzurufen. Verwenden Sie diese Schnittstelle nur, wenn Sie die IBITSExtensionSetup-Schnittstelle in einem Setupprogramm verwenden, das auch den BITS-Server installiert. Da der IIS-Cache die während des Setups hinzugefügten BITS-Erweiterungen nicht enthält, sind die Erweiterungen nicht mit der ADsGetObject ADSI-Funktion verfügbar. Die IBITSExtensionSetupFactory-Schnittstelle stellt eine GetObject-Methode bereit, die auf die BITS-Erweiterungen zugreift und dieselbe Bindung wie die ADsGetObject-Funktion ausführt.

Um einen Zeiger auf die IBITSExtensionSetupFactory-Schnittstelle zu erhalten, rufen Sie die CoCreateInstance-Funktion auf, wie in Beispielcode gezeigt.

Vererbung

Die IBITSExtensionSetupFactory-Schnittstelle erbt von der IUnknown-Schnittstelle . IBITSExtensionSetupFactory verfügt auch über folgende Membertypen:

Methoden

Die IBITSExtensionSetupFactory-Schnittstelle verfügt über diese Methoden.

Hinweise

Diese Schnittstelle wird auf dem Server registriert, wenn Sie die BITS-Servererweiterung installieren.

Verwenden Sie unter Windows Server 2003 den Assistenten für Windows-Komponenten , um die BITS-Servererweiterung zu installieren. Wählen Sie in SystemsteuerungDie Option Programme hinzufügen oder entfernen aus. Wählen Sie dann Windows-Komponenten hinzufügen/entfernen aus, um den Assistenten für Windows-Komponenten anzuzeigen. Die BITS-Servererweiterung ist eine Unterkomponente von Internetinformationsdienste (IIS), die eine Unterkomponente des Webanwendungsservers ist.

Beispiele

Das folgende Beispiel zeigt, wie Sie mithilfe der IBITSExtensionSetupFactory-Schnittstelle einen Zeiger auf die IBITSExtensionSetup-Schnittstelle abrufen.

//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;
}

Anforderungen

Weitere Informationen

IBITSExtensionSetup