Méthode IBITSExtensionSetup ::GetCleanupTaskName (bitscfg.h)
Utilisez la méthode GetCleanupTaskName pour récupérer le nom de la tâche de nettoyage associée au répertoire virtuel.
Syntaxe
HRESULT GetCleanupTaskName(
[out] BSTR *pTaskName
);
Paramètres
[out] pTaskName
Chaîne terminée par null contenant le nom de la tâche de nettoyage associée au répertoire virtuel. Si la valeur est NULL, BITS n’a pas créé de tâche de nettoyage pour le répertoire virtuel. Lorsque vous avez terminé, appelez la fonction SysFreeString pour libérer pTaskName.
Valeur retournée
Cette méthode retourne S_OK de réussite. Sinon, la méthode retourne S_FALSE si aucun nom de tâche n’a été spécifié pour le répertoire virtuel.
Remarques
Lorsque vous créez un répertoire virtuel et que vous l’activez pour les chargements BITS, BITS ajoute un élément de travail dans le Planificateur de tâches. L’élément de travail nettoie le répertoire virtuel une fois toutes les 12 heures en supprimant les travaux qui n’ont pas été modifiés dans le délai imparti. Pour spécifier le délai d’attente, définissez la propriété d’extension IIS BITSSessionTimeout .
Utilisez le nom pTaskName comme paramètre d’entrée dans le fichier exécutable Schtasks.exe, que vous pouvez utiliser pour modifier les propriétés de la tâche de nettoyage à partir d’un script.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2003 |
| Plateforme cible | Windows |
| En-tête | bitscfg.h |
| DLL | BitsMgr.dll |
| Composant redistribuable | BITS 1.5 sur Windows XP |