sp_OASetProperty (Transact-SQL)

Se aplica a: SQL Server

Establece un nuevo valor para una propiedad de un objeto OLE.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

objecttoken
Es el token de objeto de un objeto OLE creado anteriormente por sp_OACreate.

propertyname
Es el nombre de la propiedad del objeto OLE que se va establecer en un nuevo valor.

newvalue
Es el nuevo valor de la propiedad y debe ser un valor del tipo de datos apropiado.

índice
Es un parámetro de índice. Si se especifica, index debe ser un valor del tipo de datos adecuado.

Algunas propiedades tienen parámetros. Estas propiedades se llaman propiedades indizadas y los parámetros se llaman parámetros de índice. Una propiedad puede tener varios parámetros de índice.

Nota:

Los parámetros de este procedimiento almacenado se especifican por posición, no por nombre.

Valores de código de retorno

0 (correcto) o un valor distinto de cero (error) que es el valor entero del HRESULT devuelto por el objeto de OLE Automation.

Para obtener más información sobre los códigos de retorno HRESULT, vea Códigos de retorno y información de error de OLE Automation.

Permisos

Requiere la pertenencia al rol fijo de servidor sysadmin o ejecutar el permiso directamente en este procedimiento almacenado. Ole Automation Procedures la configuración debe estar habilitada para usar cualquier procedimiento del sistema relacionado con OLE Automation.

Ejemplos

En el ejemplo siguiente se establece la HostName propiedad (del objeto SQLServer creado anteriormente) en un nuevo valor.

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

Consulte también

Procedimientos almacenados de OLE Automation (Transact-SQL)
Ejemplo de script de automatización OLE