IBITSExtensionSetup-Schnittstelle (bitscfg.h)

  • Artikel

Verwenden Sie die IBITSExtensionSetup-Schnittstelle , um BITS-Uploads in ein virtuelles Verzeichnis zu aktivieren oder zu deaktivieren.

Diese Schnittstelle ist eine ADSI-Erweiterung. Um einen Zeiger auf diese Schnittstelle abzurufen, rufen Sie die ADsGetObject ADSI-Funktion auf, wie in Beispielcode gezeigt.

Wenn Sie diese Schnittstelle über ein Setupprogramm verwenden, das auch den BITS-Server installiert, müssen Sie die IBITSExtensionSetupFactory::GetObject-Methode aufrufen, um einen Zeiger auf diese Schnittstelle abzurufen, anstatt die ADsGetObject-Funktion aufzurufen.

Vererbung

Die IBITSExtensionSetup-Schnittstelle erbt von der IUnknown-Schnittstelle . IBITSExtensionSetup verfügt auch über folgende Arten von Membern:

Methoden

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

 
IBITSExtensionSetup::D isableBITSUploads

Verwenden Sie die DisableBITSUploads-Methode, um den BITS-Upload in dem virtuellen Verzeichnis zu deaktivieren, auf das das ADSI-Objekt verweist. Diese Methode legt die IIS-Erweiterungseigenschaft BITSUploadEnabled fest.
IBITSExtensionSetup::EnableBITSUploads

Verwenden Sie die EnableBITSUploads-Methode, um den BITS-Upload für das virtuelle Verzeichnis zu aktivieren, auf das das ADSI-Objekt verweist. Diese Methode legt die IIS-Erweiterungseigenschaft BITSUploadEnabled fest.
IBITSExtensionSetup::GetCleanupTask

Verwenden Sie die GetCleanupTask-Methode, um einen Schnittstellenzeiger auf den Bereinigungstask abzurufen, der dem virtuellen Verzeichnis zugeordnet ist.
IBITSExtensionSetup::GetCleanupTaskName

Verwenden Sie die GetCleanupTaskName-Methode, um den Namen des Bereinigungstasks abzurufen, der dem virtuellen Verzeichnis zugeordnet ist.

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 Software 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 Internet information Services (IIS), die eine Unterkomponente von Webanwendungsserver ist.

Beispiele

Das folgende Beispiel zeigt, wie Sie die ADsGetObject-Funktion verwenden, um einen Zeiger auf die IBITSExtensionSetup-Schnittstelle abzurufen.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2003
Zielplattform Windows
Kopfzeile bitscfg.h
Verteilbare Komponente BITS 1.5 unter Windows XP

Weitere Informationen

IBITSExtensionSetupFactory