sp_OASetProperty (Transact-sql)

ole nesnesinin bir özelliğine yeni bir değer ayarlar.

Transact-SQL Sözdizim Kuralları

Sözdizimi

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

Bağımsız değişkenler

• objecttoken
  Daha önce oluşturulan bir ole nesnesi nesne belirteci iş sp_OACreate.

• propertyname
  ole nesnesi için yeni bir değer ayarlamak için özellik adıdır.

• newvalue
  Yeni değer özelliği ve uygun veri türünü bir değer olması gerekir.

• index
  Bir dizin parametresidir. Belirtilmişse, index uygun veri türünde bir değer olmalı.

  Bazı özelliklerinin parametrelere sahiptir. Bu özellikler dizinlenmiş özellikleri denir ve parametreleri dizin parametreleri olarak adlandırılır. Bir özelliği, birden çok dizin parametreleri olabilir.

  [!NOT]

  Bu saklı yordam parametreleri konuma göre değil adı belirtilmedi.

Dönüş Kodu Değerleri

0 (başarılı) veya sıfır olmayan bir sayı (hata) ole Otomasyon nesne tarafından döndürülen hresult tamsayı değeridir.

hresult yanıt kodları hakkında daha fazla bilgi için bkz: ole Otomasyon dönüş kodları ve hata bilgileri.

İzinler

Üyelik sysadmin sunucu rolü.

Örnekler

Aşağıdaki örnek kümeleri HostNameözelliği (önceden oluşturulmuş, SQLServer nesnesi) için yeni bir değer.

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

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

Ayrıca bkz.

Başvuru

ole Otomasyon depolanan yordamlar (Transact-sql)

ole Otomasyon Örneği Komut dosyası