ISSCommandWithParameters::SetParameterProperties (OLE DB)
Ustawia właściwości parametru na podstawie parametru na przez liczba porządkowa lub ustawia właściwości parametru zbiorczej określając Tablica struktur SSPARAMPROPS.
HRESULT SetParameterProperties(
DB_UPARAMS cParams,
SSPARAMPROPS rgParamProperties[]);
Argumenty
cParams[w]
Liczba SSPARAMPROPS struktur w rgParamProperties tablicy.Jeśli liczba ta wynosi zero, ISSCommandWithParameters::SetParameterProperties spowoduje usunięcie wszystkich właściwości, które może być określony dla parametrów w poleceniu.rgParamProperties[w]
Tablica struktur SSPARAMPROPS należy ustawić.
Wartości kodów powrotnych
The ISSCommandWithParameters::SetParameterProperties metoda returns the same error codes as the core OLE DB ICommandProperties::SetProperties metoda.
Remarks
Ustawianie właściwość parametru za pomocą tej metoda jest dozwolona na podstawie parametru na Liczba porządkowa lub jednym ISSCommandWithParameters::SetParameterProperties wywołania po SSPARAMPROPS został utworzony z tablicy właściwość.
The SetParameterInfo metoda must be called before calling the ISSCommandWithParameters::SetParameterProperties metoda.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 parametr w tym wszystkie właściwości, które mogą być skojarzone z parametrem.
Wywołanie ISSCommandWithParameters::SetParameterProperties , aby określić właściwości dla parametru, który nie jest typu DBTYPE_XML lub DBTYPE_UDT zwraca DB_E_ERRORSOCCURRED lub DB_S_ERRORSOCCURRED i oznacza dwStatus pole DBPROPs wszystkie zawarte w SSPARAMPROPS dla tego parametru z DBPROPSTATUS_NOTSET.Tablica DBPROP każdego DBPROPSET zawartych w SSPARAMPROPS powinna zostać przesunięta wykrywać parametrów, które DB_E_ERRORSOCCURRED lub DB_S_ERRORSOCCURRED odwołuje się.
Jeśli ISSCommandWithParameters::zestawParameterProperties nazywa się do określania właściwości parametry, których parametr informacje nie zostały zestaw jeszcze z zestaw ParameterInfo., dostawca zwraca E_UNEXPECTED z następującym komunikatem o błędzie:
Nie można wywołać metoda SetParameterProperties dla określonych parametrów bez pierwszego wywołania metoda SetParameterInfo.Informacje o parametrach należy ustawić przed ustawieniem właściwości parametru.
Jeśli wywołanie ISSCommandWithParameters::SetParameterProperties zawiera niektóre parametry, informacje o parametr był zestaw, a niektóre parametry, których informacje parametru nie została ustawiona, dwStatus, zwraca wartość z DBSTATUS_NOTSET właściwość w DBPROPSET SSPARAMPROPS zestaw właściwość.
Struktura SSPARAMPROPS jest zdefiniowane w następujący sposób:
struct SSPARAMPROPS {
DBORDINAL iOrdinal;
ULONG cPropertySets;
DBPROPSET *rgPropertySets;
};
Element członkowski |
Description |
|---|---|
iOrdinal |
Liczba porządkowa parametru przekazana. |
cPropertySets |
Liczba DBPROPSET struktury rgPropertySets. |
rgPropertySets |
Wskaźnik do pamięci, w której zostanie zwrócona tablica struktur DBPROPSET. |