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 |