ISSCommandWithParameters::SetParameterProperties (OLE DB)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiMicrosoft Fabric'de Azure Synapse AnalyticsSQL veritabanı

OLE DB sürücüsünü indirme

Parametre özelliklerini parametre bazında ordinal olarak ayarlar veya toplu parametre özelliklerini SSPARAMPROPS yapılarından oluşan bir diziyi belirterek ayarlar.

Sözdizimi

  
HRESULT SetParameterProperties(  
      DB_UPARAMS cParams,   
      SSPARAMPROPS rgParamProperties[]);

Arguments

cParams[in]
rgParamProperties dizisindeki SSPARAMPROPS yapı sayısı. Eğer bu sayı sıfırsa, ISSCommandWithParameters::SetParameterProperties komuttaki herhangi bir parametre için belirtilmiş olabilecek tüm özellikleri silir.

rgParamProperties[in]
Ayarlanacak bir SSPARAMPROPS yapısı dizisi.

Dönüş Kodu Değerleri

ISSCommandWithParameters::SetParameterProperties yöntemi, çekirdek OLE DB ICommandProperties::SetProperties metoduyla aynı hata kodlarını döndürür.

Açıklamalar

Bu yöntemle parametre özelliklerini ayarlamak, parametre başına ordinal bazında veya SSPARAMPROPS özellik dizisinden oluşturulduktan sonra tek bir ISSCommandWithParameters::SetParameterProperties çağrısıyla izin verilir.

ISSCommandWithParameters::SetParameterProperties metodu çağrılmadan önce SetParameterInfo yöntemi çağrılmalıdır. Çağrı SetParameterProperties(0, NULL) tüm belirtilen parametre özelliklerini temizlerken, çağrı SetParameterInfo(0,NULL,NULL) parametreyle ilişkilendirilebilecek tüm parametre bilgilerini temizler.

ISSCommandWithParameters::SetParameterProperties ile DBTYPE_XML veya DBTYPE_UDT tipinde olmayan bir parametre için özellikleri belirtmek DB_E_ERRORSOCCURRED veya DB_S_ERRORSOCCURRED döner ve SSPARAMPROPS'ta bulunan tüm DBPROP'ların dwStatus alanını DBPROPSTATUS_NOTSET ile işaretler. SSPARAMPROPS'ta bulunan her DBPROPSET'in DBPROP dizisi, DB_E_ERRORSOCCURRED veya DB_S_ERRORSOCCURRED hangi parametreye atıfta bulunduğunu belirlemek için gezinmelidir.

ISSCommandWithParameters::SetParameterProperties parametre bilgisi henüz ayarlanmamış parametrelerin özelliklerini belirtmek için çağrılırsa, sağlayıcı aşağıdaki hata mesajıyla E_UNEXPECTED döner:

SetParameterProperties metodu, belirtilen parametreler için önce SetParameterInfo metodu çağrılmadan çağrılamaz. Parametre bilgileri ayarlanmadan önce parametre bilgisi ayarlanmalıdır.

ISSCommandWithParameters::SetParameterProperties çağrısında, parametre bilgisi ayarlanmış bazı parametreler ve parametre bilgisi ayarlanmamış bazı parametreler varsa, SSPARAMPROPS özellik kümesinin DBPROPSET'indeki dwStatus özellikleri DBSTATUS_NOTSET ile döner.

SSPARAMPROPS yapısı şu şekilde tanımlanır:

struct SSPARAMPROPS {

DBORDINAL iOrdinal;

ULONG cPropertySets;

DBPROPSET *rgPropertySets;

};

SQL Server 2012 (11.x) ile başlayan veritabanı motorundaki iyileştirmeler, ISSCommandWithParameters::SetParameterProperties ile beklenen sonuçların daha doğru açıklamalarını elde etmesini sağlar. Bu daha doğru sonuçlar, SQL Server'ın önceki sürümlerinde ISSCommandWithParameters::SetParameterProperties tarafından verilen değerlerden farklı olabilir. Daha fazla bilgi için bakınız: Meta Veri Keşfi.

Üye Description
iOrdinal Geçilen parametrenin sıralı.
cPropertySetSets rgPropertySet'lerdeki DBPROPSET yapılarının sayısı.
rgPropertySetler DBPROPSET yapılarının bir dizisini geri döndürmek için belleğe işaret eden bir işaretçi.

İlgili içerik

  • Son güncelleştirme: