Oródwierszową parametru pola deskryptora
Wsparcie dla tabela-wyceniane parametrów zawiera nowe SQL Server-określonych pól w deskryptorach parametr aplikacji ODBC (pochodne alkilofenoli APD) i realizacji deskryptory parametr (IPDs).
Uwagi
Nazwa |
Lokalizacja |
Typ |
Opis |
|---|---|---|---|
SQL_CA_SS_TYPE_NAME |
IPD |
SQLTCHAR * |
Nazwa typu serwera tabela-parametr wycenione. Gdy tabela-nazwa typu parametru wyceniane jest określona na wywołanie SQLBindParameter, zawsze musi być określona jako wartość Unicode, nawet w przypadku aplikacji, które są wbudowane, jak aplikacje ANSI.Wartość parametru StrLen_or_IndPtr powinien być SQL_NTS lub długość ciąg nazwy, pomnożonej przez sizeof(WCHAR). Po tabela-nazwa typu parametru wyceniane jest określony przez SQLSetDescField, można ją określić przy użyciu literału zgodne ze sposobem aplikacji jest wbudowana.Menedżer sterowników ODBC będzie wykonywać wszelkie wymagane Konwersja Unicode. |
SQL_CA_SS_TYPE_CATALOG_NAME (tylko do odczytu) |
IPD |
SQLTCHAR * |
Katalog, w którym zdefiniowano typ. |
SQL_CA_SS_TYPE_SCHEMA_NAME |
IPD |
SQLTCHAR * |
Schemat, gdzie typ jest zdefiniowany. |
Aplikacje nie może ustawić SQL_CA_SS_TYPE_CATALOG_NAME dla tabela-wycenione parametrów.Ten sposób zwróci wartość SQL_ERROR i diagnostyczne rejestrowane z SQLSTATE = HY091 i komunikat "nieprawidłowy deskryptor pole Identyfikator".
Następujące atrybuty instrukcja i pól nagłówka deskryptora dotyczą parametry oródwierszową, gdy fokus parametru jest zestaw do parametru z wartościami przechowywanymi w tabela:
Nazwa |
Lokalizacja |
Typ |
Opis |
|---|---|---|---|
SQL_ATTR_PARAMSET_SIZE (Jest to równoważne z SQL_DESC_ARRAY_SIZE w APD.) |
APD |
SQLUINTEGER |
Rozmiar tablicy tablic buforu dla tabela-parametr wycenione.Jest to maksymalna liczba wierszy pomieści buforów lub rozmiar buforów w wierszach; tabela-samą wartość parametru wyceniane może mieć więcej lub mniej wierszy niż bufor może przechowywać.Wartością domyślną jest 1. .gif "Uwaga") Uwaga:
Jeśli SQL_SOPT_SS_PARAM_FOCUS jest ustawiona na wartość domyślną 0, SQL_ATTR_PARAMSET_SIZE odnosi się do instrukcja i określa liczbę zestawów parametrów.Jeśli SQL_SOPT_SS_PARAM_FOCUS jest równa Liczba porządkowa tabela-wyceniane parametr odwołuje się do tabela-wycenione parametru oraz określa liczbę wierszy dla jednego parametru dla tabela-parametr wycenione.
|
SQL_ATTR_PARAM _BIND_TYPE |
APD |
SQLINTEGER |
Wartość domyślna to SQL_PARAM_BIND_BY_COLUMN. Aby wybrać powiązania row-wise, to pole ma wartość długości struktury lub wystąpienie buforu, która będzie związana z zestawem tabela-wycenione parametr wierszy.Długość ta musi zawierać miejsca wszystkie kolumny związanej i wszelkich uzupełnienie konstrukcji lub buforu.Dzięki temu, gdy adres kolumna związana jest zwiększana o określonej długości, początku samej kolumny w następnym wierszu będzie wskazywać wynik.Podczas korzystania z sizeof to zachowanie operator w ANSI C jest gwarantowana. |
SQL_ATTR_PARAM_BIND_OFFSET_PTR |
APD |
SQLINTEGER * |
Wartość domyślna to pusty wskaźnik. Jeśli pole to nie-null, sterownik dereferences wskaźnik dodaje wartość dereferenced do każdego odroczonego pola w rekordzie deskryptora (SQL_DESC_DATA_PTR, SQL_DESC_INDICATOR_PTR i SQL_DESC_OCTET_LENGTH_PTR) i wykorzystuje nowe wartości wskaźnika do wartości danych programu access. |
Pola te obowiązują wyłącznie z wartościami przechowywanymi w tabela parametrów i są ignorowane dla innych typów danych.
SQL_CA_SS_TYPE_NAME jest fakultatywne dla wywołania procedura składowana.Musi być określony dla instrukcji SQL, które nie są wywołaniami procedury do włączenia serwera określić typ tabela-parametr wycenione.
Jeśli nazwa typu jest wymagane, a tabela typu parametru oródwierszową jest zdefiniowany w schemacie innej niż procedura składowana, SQL_CA_SS_TYPE_SCHEMA_NAME musi być określona w deskryptorze parametr wykonania (IPD).Jeśli nie, serwer nie będzie mógł określić typu tabela-parametr wycenione.Spowoduje to błąd podczas wywoływania SQLExecute lub SQLExecDirect.Błąd będzie miał SQLSTATE = 07006 i wiadomości danych o ograniczonym dostępie typu atrybut "naruszenie zasad".
Parametr oródwierszową kolumna mogą używać row-wise lub kolumna-wise powiązanie.Wartością domyślną jest kolumna-wise powiązanie.Row-Wise powiązanie może być określony przez ustawienie SQL_ATTR_PARAM_BIND_TYPE i SQL_ATTR_ PARAM_BIND_OFFSET_PTR.To jest analogiczne do powiązanie row-wise kolumn i parametry.
SQL_CA_SS_TYPE_CATALOG_NAME i SQL_CA_SS_TYPE_SCHEMA_NAME można również pobrać z wykazu i schemat skojarzone CLR typ zdefiniowany przez użytkownika parametry.Są to alternatyw istniejące atrybuty schematu wykazu określonego typu dla tych typów.