ISSCommandWithParameters::SetParameterProperties in SQL Server Native Client (OLE DB)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnalytics Platform System (PDW)

Important

SQL Server Native Client (genellikle kısaltılmış SNAC) SQL Server 2022 (16.x) ve SQL Server Management Studio 19'dan (SSMS) kaldırılmıştır. Hem SQL Server Yerel İstemci OLE DB sağlayıcısı (SQLNCLI veya SQLNCLI11) hem de SQL Server için eski Microsoft OLE DB Sağlayıcısı (SQLOLEDB) yeni geliştirme için önerilmez. İleride SQL Server için yeni Microsoft OLE DB Sürücüsüne (MSOLEDBSQL) geçin.

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

Syntax

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.

Remarks

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 olarak DBTYPE_XML veya DBTYPE_UDT tipinde olmayan bir parametre için özellikleri belirtmek DB_E_ERRORSOCCURRED veya DB_S_ERRORSOCCURRED döner ve o parametre için 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

  • Last updated on