sp_OAMethod (Transact-SQL)

Bağımsız değişkenler

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

• methodname
  OLE nesnesini aramak için yöntem adıdır.

• returnvalue ÇIKIŞ
  Dönüş değeri, yöntem OLE nesnesinin.Belirtilmişse, bu uygun veri türünü, yerel bir değişken olmalıdır.

  Yöntem, tek bir değer döndürürse, ya da yerel bir değişken belirtin returnvalue, yerel değişkende dönüş değeri, yöntem) döndürür veya değil belirtme returnvalue, hangi yöntemin dönüş değeri istemciye geri tek sütunlu, tek satırlık bir sonucu olarak gönderir küme.

  yöntem Değerdir, bir OLE nesnesi döndürür. returnvalue 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.

  Yöntem döndüğünüzde değeri bir dizi ise returnvalue , NULL olarak küme belirtildi.

  Aşağıdakilerden herhangi biri oluştuğunda bir hata ortaya çıkar:

  • returnvalue belirtildi, ancak bu yöntem, bir değer döndürmüyor.

  • Yöntem, iki boyutlu bir dizi döndürür.

  • Yöntem, bir çıkış parametresi olarak bir dizi döndürür.

• [ @parametername**=** ] parameter[ OUTPUT ]
  Iş bir yöntem parametresi.Belirtilmişse, parameteruygun veri türünü, bir değer olmalıdır.

  Bir çıktı parametresi, dönüş değerini elde etmek için parameter uygun veri türünü, yerel bir değişken olmalı ve ÇIKIŞ belirtilmeli.Sabit bir parametre belirtildi, ya da ÇIKIŞ belirtilmezse, bir çıktı parametresini gelen herhangi bir dönüş değeri yok sayılır.

  If specified, parametername must be the name of the Microsoft Visual Basic named parameter.Note that @parameternameis not a Transact-SQL local variable.The at sign (@) is removed, and parameternameis passed to the OLE object as the parameter name.Sonra tüm konum parametreleri belirtilirse, tüm adlandırılmış parametreleri belirtilmelidir.

• n
  Yer tutucu, birden çok parametre belirtilmesini gösteren iş.

  Not

  @parametername Belirtilen parçası olduğundan, adlandırılmış bir parametre olabilir yöntem ve nesneye üzerinden iletilir.Bu saklı yordam için diğer parametreler 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 OLE Otomasyonu dönüş kodları ve hata bilgileri.

Sonuç Kümeleri

Yöntem bir veya iki boyutlu bir dizi değeri olan dönerseniz, 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.Diğer bir deyişle, dizinin (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.Yöntem çağırma

EXEC @hr = sp_OAMethod @object, 'Connect', NULL, 'my_server',
    'my_login', 'my_password'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END

b.Özellik alma

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

See Also

Reference

Other Resources