ISSCommandWithParameters::GetParameterProperties (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

Her UDT veya XML parametresi için bir SSPARAMPROPS özellik kümesi olan SSPARAMPROPS özellik kümesi yapılarından oluşan bir dizi döndürür.

Sözdizimi

  
HRESULT GetParameterProperties(  
      DB_UPARAMS *pcParams,  
      SSPARAMPROPS **prgParamProperties);  

Bağımsız değişken

pcParams[out][in]
prgParamPropertiesiçinde döndürülen SSPARAMPROPS yapılarının sayısını içeren bir bellek işaretçisi.

prgParamProperties[out]
Bir dizi SSPARAMPROPS yapısının döndürüldiği belleğe yönelik bir işaretçi. Sağlayıcı yapılar için bellek ayırır ve adresi bu belleğe döndürür, tüketici artık yapılara ihtiyaç kalmadığında bu belleği IMalloc::Free ile serbest bırakır. tüketici, IMalloc::Freeiçin çağırmadan önce, değişkenin BSTR gibi bir başvuru türü içerdiği durumlarda bellek sızıntısını önlemek için her DBPROP yapısının VariantClear özelliği için de çağırmalıdır. pcParams çıktıda sıfırsa veya DB_E_ERRORSOCCURRED dışında bir hata oluşursa sağlayıcı herhangi bir bellek ayırmaz ve prgParamProperties çıkışta null işaretçi olduğundan emin olur.

Dönüş Kodu Değerleri

GetParameterProperties yöntemi, DB_S_ERRORSOCCURRED ve DB_E_ERRORSOCCURRED oluşturulamamaları dışında çekirdek OLE DB ICommandProperties::GetProperties yöntemiyle aynı hata kodlarını döndürür.

Açıklamalar

ISSCommandWithParameters::GetParameterProperties yöntemi, GetParameterInfoile tutarlı bir şekilde davranır. ISSCommandWithParameters::SetParameterProperties veya SetParameterInfo çağrılmadıysa veya sıfıra eşit cParams ile çağrıldıysa, GetParameterInfo parametre bilgilerini türetir ve döndürür. En az bir parametre için ISSCommandWithParameters::SetParameterProperties veya SetParameterInfo çağrıldıysa, ISSCommandWithParameters::GetParameterProperties yöntemi yalnızca ISSCommandWithParameters::SetParameterProperties çağrıldığı parametrelerin özelliklerini döndürür. ISSCommandWithParameters::SetParameterProperties ISSCommandWithParameters::GetParameterProperties veya GetParameterInfosonra çağrılırsa, ISSCommandWithParameters::GetParameterProperties sonraki çağrılar, ISSCommandWithParameters::SetParameterProperties yönteminin çağrıldığı parametreler için geçersiz kılınan değerleri döndürür.

SSPARAMPROPS yapısı aşağıdaki gibi tanımlanır:

struct SSPARAMPROPS {

DBORDINAL iOrdinal;

ULONG cPropertySets;

DBPROPSET *rgPropertySets;

};

Üye	Açıklama
iOrdinal	Geçirilen parametrenin sıralı değeri.
cPropertySets	rgPropertySetsiçindeki DBPROPSET yapılarının sayısı.
rgPropertySets	DBPROPSET yapılarından oluşan bir dizi döndürülecek belleğe yönelik bir işaretçi.

İlgili içerik

• ISSCommandWithParameters (OLE DB)