Freigeben über


IBITSExtensionSetup::GetCleanupTaskName-Methode (bitscfg.h)

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

Syntax

HRESULT GetCleanupTaskName(
  [out] BSTR *pTaskName
);

Parameter

[out] pTaskName

Null-beendete Zeichenfolge, die den Namen der Bereinigungsaufgabe enthält, die dem virtuellen Verzeichnis zugeordnet ist. Bei NULL hat BITS keine Bereinigungsaufgabe für das virtuelle Verzeichnis erstellt. Wenn Sie fertig sind, rufen Sie die SysFreeString-Funktion auf, um pTaskName frei zu geben.

Rückgabewert

Diese Methode gibt S_OK für den Erfolg zurück. Andernfalls gibt die Methode S_FALSE zurück, wenn kein Aufgabenname für das virtuelle Verzeichnis angegeben wurde.

Hinweise

Wenn Sie ein virtuelles Verzeichnis erstellen und für BITS-Uploads aktivieren , fügt BITS im Aufgabenplaner ein Arbeitselement hinzu. Das Arbeitselement bereinigt das virtuelle Verzeichnis einmal alle 12 Stunden, indem Aufträge gelöscht werden, die innerhalb des Timeoutzeitraums nicht geändert wurden. Um den Timeoutzeitraum anzugeben, legen Sie die IIS-Erweiterungseigenschaft BITSSessionTimeout fest.

Verwenden Sie den Namen pTaskName als Eingabeparameter für die Schtasks.exe ausführbare Datei, die Sie verwenden können, um die Eigenschaften des Bereinigungstasks aus einem Skript zu ändern.

Anforderungen

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

Weitere Informationen

IBITSExtensionSetup::EnableBITSUploads

IBITSExtensionSetup::GetCleanupTask