执行先前定义的 Web 作业并生成 HTML 文档。要运行的任务由输出文件名或过程名标识，或者由两个参数同时标识。

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

语法

sp_runwebtask [ [ @procname = ] 'procname' ]

    [ , [ @outputfile = ] 'outputfile'

参数

[@procname =] 'procname'

是要运行的 Web 作业过程的名称。指定的过程定义了 Web 作业的查询。procname 为 nvarchar(128) 类型，无默认值。

[@outputfile =] 'outputfile'

是指定 Web 作业的输出文件名。outputfile 为 nvarchar(255) 类型，无默认值。

返回代码值

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

注释

sp_runwebtask 必须在 sp_makewebtask 的 dbname 所指定的同一数据库中执行。

系统管理员不应使用 SETUSER 测试 sp_runwebtask。扩展过程并不理会新用户的安全上下文。要测试适当的安全授权，请创建临时用户 ID 和密码。使用这一临时帐户登录并测试 sp_runwebtask。测试完成后删除临时帐户。

由 sp_runwebtask 生成的输出是真正的 HTML 源代码。可使用大多数文字处理应用程序查看源文档。

重要  sp_dropwebtask、sp_makewebtask 和 sp_runwebtask 只能在 Microsoft® SQL Server™ 6.5 版及其更高版本的数据库上运行。在以前版本的数据库中运行这些过程会返回错误。

当某作业定期调度运行时，SQL Server 代理必须处于运行状态。否则将不能生成 .htm 页。

所有 Microsoft Windows® 95/98 Web 助手的用户都必须在正使用的数据库中有用户帐户。使用 sp_adduser 向每个用户可能访问的数据库添加帐户。当运行 Windows 95/98 操作系统时，按需分配任务只能由作业所有者或系统管理员运行。

权限

用户要运行由 Web 作业使用的指定查询，就必须具有 SELECT 权限。

示例

下例使用 @outputfile 参数 C:\Web\Myfile.html 和 @procname 参数 MYHTML 运行 Web 作业。

sp_runwebtask @procname = 'MYHTML', @outputfile = 'C:\WEB\MYFILE.HTML'