Partager via


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

Voir aussi

IBITSExtensionSetup ::EnableBITSUploads

IBITSExtensionSetup ::GetCleanupTask