删除先前定义的 Web 任务。

说明  在 SQL Server 企业管理器的"作业分类"对话框中，所有的 Web 任务或作业都被分类成"Web 助手"。有关更多信息，请参见定义作业。

语法

sp_dropwebtask { [ @procname = ] 'procname' | [ , @outputfile = ] 'outputfile' }

参数

[@procname =] 'procname'

为任务定义查询的那个过程的名称。procname 的数据类型为 nvarchar(128)，带有默认值 NULL。

[@outputfile =] 'outputfile'

将被删除的 HTML 输出文件的名称。outputfile 的数据类型为 nvarchar(255)，带有默认值 NULL。

返回代码值

0（成功）或一个非零数字（失败）

重要  返回代码值已不同于 Microsoft® SQL Server™ 的早期版本。

结果集

无

注释

sp_dropwebtask 接受两个参数中的一个或同时接受两个参数。如果指定 outputfile，而不带有 procname，那么可以为 procname 指定一个占位值 NULL，或者也可以使用参数名 @procname。下面两个示例是等价的：

sp_dropwebtask NULL,'filename.htm'
sp_dropwebtask @procname = 'filename.htm'

必须在某个特定的数据库中执行 sp_dropwebtask，这个数据库就是由 sp_makewebtask 的 dbname 参数指定的那个数据库。

在 Microsoft SQL Server 7.0 版本之前的数据库上运行 sp_dropwebtask 会返回一个错误。

权限

只有指定的过程的所有者才可以执行 sp_dropwebtask 以删除 Web 任务。

示例

下面的示例删除一个 Web 任务，该任务带有输出文件 C:\Web\Myfile.html 以及一个名为 MYHTML 的过程。

sp_dropwebtask 'MYHTML', 'C:\WEB\MYFILE.HTML'