ISSCommandWithParameters::SetParameterProperties (OLE DB)
Ustawia właściwości parametru na podstawie parametru na porządkowe lub ustawia właściwości parametru luzem, określając Tablica struktur SSPARAMPROPS.
Składnia
HRESULT SetParameterProperties(
DB_UPARAMS cParams,
SSPARAMPROPS rgParamProperties[]);
Argumenty
cParams[w]
Liczba SSPARAMPROPS struktur w rgParamProperties tablicy.Jeśli ta liczba jest zero, ISSCommandWithParameters::SetParameterProperties spowoduje usunięcie wszystkich właściwości, które może być określone dla wszystkich parametrów w poleceniu.rgParamProperties[w]
Tablica struktur SSPARAMPROPS się zestaw.
Wartości kodów powrotnych
ISSCommandWithParameters::SetParameterProperties metoda zwraca te same kody błędów jako podstawowe OLE DB ICommandProperties::SetProperties metody.
Uwagi
Ustawianie właściwość parametru za pomocą tej metoda jest dozwolone na podstawie parametru na porządkowe lub pojedynczym ISSCommandWithParameters::SetParameterProperties wywołania po SSPARAMPROPS został utworzony z tablicy właściwość.
Metoda SetParameterInfo przed wywoływaniem należy wywołać metodę ISSCommandWithParameters::SetParameterProperties metody.Wywołanie SetParameterProperties(0, NULL) czyści wszystkie właściwości określonego parametru, podczas telefonicznej SetParameterInfo(0,NULL,NULL) czyści wszystkie informacje o parametrach łącznie wszystkie właściwości, które mogą być skojarzone z parametrem.
Wywołanie ISSCommandWithParameters::SetParameterProperties , aby określić właściwości parametr, który nie jest typu DBTYPE_XML lub DBTYPE_UDT zwraca DB_E_ERRORSOCCURRED lub DB_S_ERRORSOCCURRED i znaczniki dwStatus pole z DBPROPs wszystkie zawarte w SSPARAMPROPS dla parametru DBPROPSTATUS_NOTSET.Tablica DBPROP każdego DBPROPSET zawartych w SSPARAMPROPS powinny przesunięta do wykrywać parametr, który odwołuje się DB_E_ERRORSOCCURRED lub DB_S_ERRORSOCCURRED.
Jeśli ISSCommandWithParameters::zestawParameterProperties nazywa się do określania właściwości parametry, których parametr informacje nie zostały zestaw jeszcze z zestawParameterInfo, dostawca zwraca E_UNEXPECTED z następujący komunikat o błędzie:
Nie można wywołać metody SetParameterProperties dla określonych parametrów bez pierwszego wywołania metody metoda SetParameterInfo.Informacje na temat parametrów muszą być zestaw przed zestawwyrównywania właściwości parametru.
Jeśli wywołanie ISSCommandWithParameters::SetParameterProperties zawiera niektóre parametry, gdzie ustawiono parametr info i niektórych parametrów, których nie ustawiono parametr info, właściwość dwStatus w DBPROPSET zestaw właściwość SSPARAMPROPS zwróci się z DBSTATUS_NOTSET.
Struktura SSPARAMPROPS się następująco:
struct SSPARAMPROPS {
DBORDINAL iOrdinal;
ULONG cPropertySets;
DBPROPSET *rgPropertySets;
};
Element członkowski |
Opis |
|---|---|
iOrdinal |
Liczba porządkowa parametru przekazany. |
cPropertySets |
Liczba DBPROPSET struktur w rgPropertySets. |
rgPropertySets |
Wskaźnik do pamięci, w której zostanie zwrócona tablica struktur DBPROPSET. |