IBITSExtensionSetup：：GetCleanupTaskName 方法 (bitscfg.h)

使用 GetCleanupTaskName 方法检索与虚拟目录关联的清理任务的名称。

语法

HRESULT GetCleanupTaskName(
  [out] BSTR *pTaskName
);

[out] pTaskName

以 Null 结尾的字符串，包含与虚拟目录关联的清理任务的名称。如果 为 NULL，则表示 BITS 尚未为虚拟目录创建清理任务。完成后，调用 SysFreeString 函数以释放 pTaskName。

此方法返回 成功S_OK 。否则，如果尚未为虚拟目录指定任务名称，方法将返回 S_FALSE 。

创建虚拟目录并为其启用 BITS 上传时，BITS 会在任务计划程序中添加一个工作项。工作项通过删除在超时期限内未修改的作业，每 12 小时清理一次虚拟目录。若要指定超时期限，请设置 BITSSessionTimeout IIS 扩展属性。

使用 pTaskName 名称作为 Schtasks.exe 可执行文件的输入参数，可用于从脚本更改清理任务的属性。