sp_OASetProperty (Transact-SQL)

Устанавливает новое значение свойства OLE-объекта.

Соглашения о синтаксисе в Transact-SQL

Синтаксис

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

Аргументы

• objecttoken
  Маркер OLE-объекта, предварительно созданный с помощью процедуры sp_OACreate.

• propertyname
  Имя свойства OLE-объекта, которому присваивается новое значение.

• newvalue
  Новое значение свойства должно быть величиной соответствующего типа данных.

• index
  Индексный аргумент. Если значение указано, то аргумент index должен быть величиной соответствующего типа данных.

  Некоторые свойства имеют аргументы. Эти свойства называются индексированными свойствами, а аргументы — индексными аргументами. Свойство может иметь несколько индексных аргументов.

  Примечание.
  Аргументы для данной хранимой процедуры указываются по позиции, а не по имени.

Значения кодов возврата

0 (успешное завершение) или ненулевой номер (неуспешное завершение), который является целочисленным значением HRESULT, возвращаемым объектом OLE-автоматизации.

Дополнительные сведения о кодах возврата 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-автоматизации

Справка и поддержка

Получение помощи по SQL Server 2005