SQLNumResultCols, funkcja

Zgodność
Wersja wprowadzona: Zgodność ze standardami ODBC 1.0: ISO 92

Podsumowanie
SQLNumResultCols zwraca liczbę kolumn w zbiorze wyników.

Syntax

  
SQLRETURN SQLNumResultCols(  
     SQLHSTMT        StatementHandle,  
     SQLSMALLINT *   ColumnCountPtr);

Arguments

StatementHandle
[Dane wejściowe] Uchwyt instrukcji.

ColumnCountPtr
[Wyjście] Wskaźnik do bufora, w którym zwraca liczbę kolumn w zbiorze wyników. To liczenie nie obejmuje oprawionej kolumny zakładek.

Zwroty

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR lub SQL_INVALID_HANDLE.

Diagnostyka

Gdy SQLNumResultCols zwraca SQL_ERROR lub SQL_SUCCESS_WITH_INFO, można uzyskać powiązaną wartość SQLSTATE, wywołując SQLGetDiagRec z HandleType SQL_HANDLE_STMT oraz HandleStatementHandle. Poniższa tabela przedstawia wartości SQLSTATE najczęściej zwracane przez SQLNumResultCols i wyjaśnia każdą z nich w kontekście tej funkcji; notacja "(DM)" poprzedza opisy stanów SQL zwracanych przez Menedżera Sterowników. Kod zwracany skojarzony z każdą wartością SQLSTATE jest SQL_ERROR, chyba że określono inaczej.

SQLSTATE Error Opis
01000 Ostrzeżenie ogólne Komunikat informacyjny specyficzny dla sterownika. (Funkcja zwraca SQL_SUCCESS_WITH_INFO).
08S01 Błąd połączenia komunikacyjnego Połączenie komunikacyjne między sterownikiem a źródłem danych, z którym sterownik został połączony, nie powiodło się przed zakończeniem przetwarzania funkcji.
HY000 Błąd ogólny Wystąpił błąd, dla którego nie było określonego stanu SQLSTATE i dla którego nie zdefiniowano parametru SQLSTATE specyficznego dla implementacji. Komunikat o błędzie zwrócony przez element SQLGetDiagRec w buforze *MessageText opisuje błąd i jego przyczynę.
HY001 Błąd alokacji pamięci Sterownik nie może przydzielić pamięci wymaganej do obsługi wykonywania lub ukończenia funkcji.
HY008 Operacja anulowana Przetwarzanie asynchroniczne zostało włączone dla instrukcji StatementHandle. Funkcja była wywoływana, a przed zakończeniem wykonania wywoływano SQLCancel lub SQLCancelHandle na CommandHandle; funkcja była następnie wywoływana ponownie na CommandHandle.

Wywołano funkcję , a przed zakończeniem wykonywania wywołano funkcję SQLCancel lub SQLCancelHandle na instrukcjiHandle z innego wątku w aplikacji wielowątku.
HY010 Błąd sekwencji funkcji (DM) Asynchronicznie wykonywana funkcja została wywołana dla dojścia połączenia skojarzonego z instrukcją StatementHandle. Ta asynchroniczna funkcja działała nadal, gdy wywoływano funkcję SQLNumResultsCols .

(DM) SqlExecute, SQLExecDirect lub SQLMoreResults została wywołana dla instrukcji StatementHandle i zwrócona SQL_PARAM_DATA_AVAILABLE. Ta funkcja została wywołana przed pobraniem danych dla wszystkich parametrów przesyłanych strumieniowo.

(DM) Funkcja była wywoływana przed wywołaniem SQLPrepare lub SQLExecDirect dla CommandHandle.

(DM) Asynchronicznie wykonująca funkcję (a nie tę) została wywołana dla instrukcji StatementHandle i nadal była wykonywana, gdy ta funkcja została wywołana.

(DM) SQLExecute, SQLExecDirect, SQLBulkOperations lub SQLSetPos został wywołany dla instrukcjiHandle i zwrócił SQL_NEED_DATA. Ta funkcja została wywołana przed wysłaniem danych dla wszystkich parametrów wykonywania danych lub kolumn.

Zobacz funkcję SQLPrepare, aby uzyskać szczegóły dotyczące tego, kiedy uchwyt instrukcji może zostać uwolniony.
HY013 Błąd zarządzania pamięcią Nie można przetworzyć wywołania funkcji, ponieważ nie można uzyskać dostępu do bazowych obiektów pamięci, prawdopodobnie z powodu niskich warunków pamięci.
HY117 Połączenie jest zawieszone z powodu nieznanego stanu transakcji. Dozwolone są tylko funkcje rozłączania i tylko do odczytu. (DM) Aby uzyskać więcej informacji na temat stanu wstrzymania, zobacz SQLEndTran, funkcja.
HYT01 Upłynął limit czasu połączenia Okres przekroczenia limitu czasu połączenia wygasł, zanim źródło danych odpowiedziało na żądanie. Limit czasu połączenia jest ustawiany za pomocą parametru SQLSetConnectAttr, SQL_ATTR_CONNECTION_TIMEOUT.
IM001 Sterownik nie obsługuje tej funkcji (DM) Sterownik skojarzony z instrukcją StatementHandle nie obsługuje funkcji.
IM017 Sondowanie jest wyłączone w trybie powiadomień asynchronicznych Za każdym razem, gdy jest używany model powiadomień, sondowanie jest wyłączone.
IM018 Funkcja SQLCompleteAsync nie została wywołana w celu ukończenia poprzedniej operacji asynchronicznej na tym dojściu. Jeśli poprzednie wywołanie funkcji na dojściu zwraca SQL_STILL_EXECUTING i jeśli tryb powiadomień jest włączony, narzędzie SQLCompleteAsync musi być wywoływane na dojściu, aby wykonać przetwarzanie końcowe i zakończyć operację.

SQLNumResultCols może zwracać dowolny stan SQL, który SQLPrepare lub SQLExecute może być wywołany po SQLPrepare i przed SQLExecute, w zależności od momentu, kiedy źródło danych ocenia polecenie SQL powiązane z danym zakatem.

Comments

SQLNumResultCols mogą być wywołane pomyślnie tylko wtedy, gdy instrukcja znajduje się w stanie przygotowanym, wykonanym lub pozycjonowanym.

Jeśli polecenie powiązane z CommandHandle nie zwraca kolumn, SQLNumResultCols ustawia *ColumnCountPtr na 0.

Liczba kolumn zwracanych przez SQLNumResultCols jest taka sama jak pole SQL_DESC_COUNT w IRD.

Więcej informacji można znaleźć w artykule Został utworzony zestaw wyników? oraz Jak są metadane wykorzystywane?.

Aby uzyskać informacje o Zobacz
Wiązanie buforu z kolumną w zestawie wyników SQLBindCol, funkcja
Anulowanie przetwarzania instrukcji SQLCancel, funkcja
Zwracanie informacji o kolumnie w zbiorze wyników Funkcja SQLColAttribute
Zwracanie informacji o kolumnie w zbiorze wyników SQLDescribeCol Function
Wykonywanie instrukcji SQL Funkcja SQLExecDirect
Wykonywanie przygotowanej instrukcji SQL SQLExecute, funkcja
Pobieranie bloku danych lub przewijanie zestawu wyników SQLFetchScroll, funkcja
Pobieranie pojedynczego wiersza lub bloku danych w kierunku tylko do przodu SQLFetch, funkcja
Pobieranie części lub całej kolumny danych SQLGetData, funkcja
Przygotowanie instrukcji SQL do wykonania SQLPrepare, funkcja
Ustawianie opcji przewijania kursora SQLSetStmtAttr, funkcja

Treści powiązane

  • Last updated on