SQLNumResultCols-funktion

Överensstämmelse
Version introducerad: ODBC 1.0 Standardefterlevnad: ISO 92

Summary
SQLNumResultCols returnerar antalet kolumner i en resultatuppsättning.

Syntax

  
SQLRETURN SQLNumResultCols(  
     SQLHSTMT        StatementHandle,  
     SQLSMALLINT *   ColumnCountPtr);

Arguments

StatementHandle
[Indata] Instruktionshandtag.

ColumnCountPtr
[Utdata] Pekare till en buffert där antalet kolumner i resultatuppsättningen returneras. Denna räkning inkluderar inte en bunden bokmärkeskolumn.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR eller SQL_INVALID_HANDLE.

Diagnostics

När SQLNumResultCols returnerar SQL_ERROR eller SQL_SUCCESS_WITH_INFO kan ett associerat SQLSTATE-värde erhållas genom att anropa SQLGetDiagRec med en HandleType av SQL_HANDLE_STMT och ett Handle av StatementHandle. Följande tabell listar de SQLSTATE-värden som vanligtvis returneras av SQLNumResultCols och förklarar var och en i kontexten av denna funktion; notationen "(DM)" föregår beskrivningarna av SQLSTATE som returneras av Driver Manager. Returkoden som är associerad med varje SQLSTATE-värde är SQL_ERROR, om inget annat anges.

SQLSTATE Error Description
01000 Allmän varning Informationsmeddelande för drivrutinsspecifikt. (Funktionen returnerar SQL_SUCCESS_WITH_INFO.)
08S01 Kommunikationslänkfel Kommunikationslänken mellan drivrutinen och datakällan som drivrutinen var ansluten till misslyckades innan funktionen slutförde bearbetningen.
HY000 Allmänt fel Ett fel uppstod för vilket det inte fanns någon specifik SQLSTATE och för vilken ingen implementeringsspecifik SQLSTATE definierades. Felmeddelandet som returnerades av SQLGetDiagRec i *MessageText-bufferten beskriver felet och dess orsak.
HY001 Fel vid minnesallokering Drivrutinen kunde inte allokera minne som krävs för körning eller slutförande av funktionen.
HY008 Åtgärden avbröts Asynkron bearbetning aktiverades för StatementHandle. Funktionen anropades, och innan den var klar med exekveringen anropades SQLCancel eller SQLCancelHandle på StatementHandle; funktionen anropades sedan igen på StatementHandle.

Funktionen anropades och innan körningen slutfördes anropades SQLCancel eller SQLCancelHandle på StatementHandle från en annan tråd i ett flertrådsprogram.
HY010 Funktionssekvensfel (DM) En asynkront körande funktion anropades för anslutningshandtaget som är associerat med StatementHandle. Denna asynkrona funktion kördes fortfarande när SQLNumResultsCols-funktionen anropades .

(DM) SQLExecute, SQLExecDirect eller SQLMoreResults anropades för StatementHandle och returnerades SQL_PARAM_DATA_AVAILABLE. Den här funktionen anropades innan data hämtades för alla strömmade parametrar.

(DM) Funktionen anropades innan SQLPrepare eller SQLExecDirect anropades för StatementHandle.

(DM) En asynkront körande funktion (inte den här) anropades för StatementHandle och kördes fortfarande när den här funktionen anropades.

(DM) SQLExecute, SQLExecDirect, SQLBulkOperations eller SQLSetPos anropades för StatementHandle och returnerades SQL_NEED_DATA. Den här funktionen anropades innan data skickades för alla data-at-execution-parametrar eller kolumner.

Se SQLPrepare-funktionen för detaljer om när ett satshandtag kan frigöras.
HY013 Minneshanteringsfel Det gick inte att bearbeta funktionsanropet eftersom det inte gick att komma åt underliggande minnesobjekt, möjligen på grund av minnesbrist.
HY117 Anslutningen pausas på grund av okänt transaktionstillstånd. Endast frånkopplings- och skrivskyddade funktioner tillåts. (DM) Mer information om pausat tillstånd finns i SQLEndTran-funktion.
HYT01 Tidsgränsen för anslutningen gick ut Tidsgränsen för anslutningen löpte ut innan datakällan svarade på begäran. Tidsgränsen för anslutningen anges via SQLSetConnectAttr, SQL_ATTR_CONNECTION_TIMEOUT.
IM001 Drivrutinen stöder inte den här funktionen (DM) Drivrutinen som är associerad med StatementHandle stöder inte funktionen.
IM017 Avsökning är inaktiverat i asynkront meddelandeläge När meddelandemodellen används inaktiveras avsökningen.
IM018 SQLCompleteAsync har inte anropats för att slutföra den tidigare asynkrona åtgärden på det här handtaget. Om det tidigare funktionsanropet på handtaget returnerar SQL_STILL_EXECUTING och om meddelandeläget är aktiverat måste SQLCompleteAsync anropas på handtaget för att utföra efterbearbetningen och slutföra åtgärden.

SQLNumResultCols kan returnera vilket SQLSTATE som helst som kan returneras av SQLPrepare eller SQLExecute när det anropas efter SQLPrepare och före SQLExecute, beroende på när datakällan utvärderar SQL-satsen som är kopplad till satsen.

Comments

SQLNumResultCols kan endast anropas framgångsrikt när satsen är i tillståndet prepared, executed eller positioned.

Om satsen som är kopplad till StatementHandle inte returnerar kolumner, sätter SQLNumResultCols *ColumnCountPtr till 0.

Antalet kolumner som returneras av SQLNumResultCols är samma värde som det SQL_DESC_COUNT fältet i IRD:n.

För mer information, se Var en resultatuppsättning skapad? och Hur används metadata?.

Mer information om Se
Binda en buffert till en kolumn i en resultatuppsättning SQLBindCol-funktion
Avbryta instruktionsbearbetning SQLCancel-funktion
Returnerar information om en kolumn i en resultatmängd SQLColAttribut-funktionen
Returnerar information om en kolumn i en resultatmängd SQLDescribeCol-funktionen
Exekvering av en SQL-sats SQLExecDirect-funktionen
Köra en förberedd SQL-instruktion SQLExecute-funktion
Hämtar ett datablock eller bläddrar igenom en resultatuppsättning SQLFetchScroll-funktion
Att hämta en enda rad eller ett datablock i en framåtriktad riktning SQLFetch-funktion
Hämtar en del av eller hela en datakolumn SQLGetData-funktion
Förberedelse av en SQL-sats för exekvering SQLPrepare-funktion
Ange markörrullningsalternativ SQLSetStmtAttr-funktion

Relaterat innehåll

  • Last updated on