Aracılığıyla paylaş

  • Makale

sp_OASetProperty (Transact-SQL)

Bir OLE nesnesinin bir özellik için yeni değer ayarlar.

Topic link iconTransact-SQL sözdizimi kuralları

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

Bağımsız değişkenler

  • objecttoken
    Daha önce oluşturulan bir OLE nesnesi Nesne simgesi iş sp_OACreate.

  • propertyname
    özellik adı OLE nesnesine küme için yeni bir değer.

  • newvalue
    Yeni özelliğin değer ve uygun bir veri türünde bir değer olmalıdır.

  • index
    Bir dizin parametresi olarak belirtilir.Belirtilmişse, index uygun veri türünü, bir değer olmalıdır.

    Bazı özellikler parametrelere sahiptir.Bu özellikler, dizinlenmiş özelliklerin denir ve parametreleri, dizin Parametreler denir.Bir özellik, 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 OLE Otomasyon nesne tarafından döndürülen HRESULT Tamsayı değeri sıfır olmayan bir sayı (hata).

Yanıt HRESULT kodları hakkında daha fazla bilgi için bkz: OLE Otomasyonu dönüş kodları ve hata bilgileri.

İzinler

Üyelik gerektirir sysadmin sabit sunucu rolü.

Örnekler

Aşağıdaki örnek ayarlar HostName özellik (daha önce oluşturulmuş SQL Server nesnesi) için yeni bir değer.

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