sp_OAGetProperty (Transact-SQL)

Bağımsız değişkenler

• objecttoken
  Nesne simge kullanarak daha önce oluşturulan bir OLE nesnesinin iş sp_OACreate.

• propertyname
  OLE nesnesini döndürmek için özellik adıdır.

• propertyvalueÇIKIŞ
  Döndürülen özellik değerdir.Belirtilmişse, bu uygun veri türünü, yerel bir değişken olmalıdır.

  Bu özellik bir OLE nesnesi döndürür. propertyvalue bir yerel değişken veri türünde olmalıdır int. Bir nesne simge, yerel değişken olarak depolanır ve bu nesneyi bir simge ile diğer depolanan Otomasyonu yordamlar kullanılabilir.

  Özelliği, tek bir değer döndürürse, ya da yerel bir değişken belirtin propertyvalue, özelliği değerini döndürür; yerel değişken değeri veya değil belirtme propertyvalue, hangi özelliğinin değeri istemciye geri tek sütunlu, tek satırlık bir sonucu olarak gönderir küme.

  Ne zaman özellik bir dizi verir propertyvalue , NULL olarak küme belirtildi.

  If propertyvalue belirtildi, ancak bu özelliğin değeri, hata oluşur döndürmüyor. özellik iki boyutlu bir dizi döndürür, hata oluşur.

• index
  Bir dizin parametresi olarak belirtilir.Belirtilmişse, indexuygun 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.

Sonuç Kümeleri

özellik bir veya iki boyutlu bir dizi döndürür, dizinin istemciye sonuç olarak döndürülen küme:

• Tek boyutlu BIR dizi tek satırlık bir sonucu olarak istemciye döndürülen küme dizideki öğelerin kadar çok sütun.Baþka bir deyiþle, dizi, sütun olarak döndürülür.

• Iki boyutlu BIR dizi sonuç olarak istemciye döndürülen küme kadar öğeleri boyutun ikinci dizi öğelerini kadar satır ve dizinin ilk boyutunun çok sütunlu.Diğer bir deyişle, dizinin (sütun, satır) olarak döndürülür.

Bir özellik dönüş değeri veya yönteminin dönüş değeri, dizesi biçimindedir. sp_OAGetProperty or sp_OAMethod bir sonuç döndüreceği için küme istemcisine.(Yöntem çıkış parametreleri dizi olamaz.) Bu yordamlar, uygun olarak belirlemek için dizideki tüm veri değerleri TaraSQL Server veri türleri ve veri uzunluğu sonuç her sütun için ayarlayın. Bu yordamlar, belirli bir sütun için o sütundaki tüm verileri göstermek için gerekli uzunluk ve veri türünü kullanın.

Bu veri türü, bir sütundaki tüm veri değerleri, aynı veri türünde paylaştırdığınız zaman, tüm sütun için kullanılır.Bir sütundaki veri değerlerinin farklı veri türleri, tüm sütun veri türü temel alınarak aşağıdaki grafikte seçilir.

Remarks

Ayrıca sp_OAMethod bir özellik değeri alınamadı.

İzinler

Üyelik gerektirir sysadmin sabit sunucu rolü.

Örnekler

C.Bir yerel değişken kullanma.

DECLARE @property varchar(255)
EXEC @hr = sp_OAGetProperty @object, 'HostName', @property OUT
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END
PRINT @property

b.Bir sonuç kullanarak küme

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

See Also

Reference

Other Resources