IBITSExtensionSetup-Schnittstelle (bitscfg.h)
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 |