sp_OASetProperty (Transact-SQL)

将 OLE 对象的属性设置为新值。

Transact-SQL 语法约定

语法

sp_OASetProperty objecttoken , propertyname , newvalue [ , index... ]

参数

• objecttoken
  以前用 sp_OACreate 创建的 OLE 对象的对象令牌。

• propertyname
  要设置新值的 OLE 对象的属性名。

• newvalue
  属性的新值，并且必须是适当数据类型的值。

• index
  索引参数。如果指定了此参数，则 index 必须是相应数据类型的值。

  有些属性包含参数。这些属性称为索引化属性，相应的参数被称为索引参数。一个属性可有多个索引参数。

  注意
  此存储过程的参数按位置（而不是名称）指定。

返回代码值

0（成功）或非零数字（失败），是由 OLE 自动化对象返回的 HRESULT 的整数值。

有关 HRESULT 返回代码的详细信息，请参阅 OLE 自动化返回代码和错误信息。

权限

要求具有 sysadmin 固定服务器角色的成员身份。

示例

以下示例将 HostName 属性（属于以前创建的 SQLServer 对象）设置为新值。

EXEC @hr = sp_OASetProperty @object, 'HostName', 'Gizmo'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END

请参阅

参考

OLE 自动存储过程 (Transact-SQL)

OLE 自动化脚本示例