SQLGetStmtAttr

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

De SQL Server Native Client ODBC-driver breidt SQLGetStmtAttr uit om driver-specifieke statementattributen te tonen.

SQLSetStmtAttr vermeldt statementattributen die zowel gelezen als geschreven zijn. Dit onderwerp vermeldt de alleen-lezen statement-attributen.

SQL_SOPT_SS_CURRENT_COMMAND

Het attribuut SQL_SOPT_SS_CURRENT_COMMAND geeft het huidige commando van een commandobatch weer open. De return is een geheel getal dat de locatie van het commando in de batch aangeeft. De ValuePtr-waarde is van het type SQLLEN.

SQL_SOPT_SS_NOCOUNT_STATUS

Het attribuut SQL_SOPT_SS_NOCOUNT_STATUS geeft de huidige instelling van de NOCOUNT optie aan, die bepaalt of SQL Server het aantal rijen rapporteert dat door een instructie wordt beïnvloed wanneer SQLRowCount wordt aangeroepen. De ValuePtr-waarde is van het type SQLLEN.

Value Description
SQL_NC_OFF NOCOUNT is UIT. SQLRowCount geeft het aantal getroffen rijen terug.
SQL_NC_ON NOCOUNT is aan. Het aantal getroffen rijen wordt niet teruggegeven door SQLRowCount en de teruggegeven waarde is 0.

Als SQLRowCount 0 teruggeeft, zou de applicatie SQL_SOPT_SS_NOCOUNT_STATUS moeten testen. Als SQL_NC_ON wordt teruggegeven, geeft de waarde 0 van SQLRowCount alleen aan dat SQL Server geen rijtelling heeft teruggegeven. Als SQL_NC_OFF wordt teruggegeven, betekent dit dat NOCOUNT niet uit is en geeft de waarde 0 van SQLRowCount aan dat de instructie geen enkele rij heeft beïnvloed.

Applicaties mogen de waarde van SQLRowCount niet tonen wanneer SQL_SOPT_SS_NOCOUNT_STATUS SQL_NC_OFF is. Grote batches of opgeslagen procedures kunnen meerdere SET NOCOUNT statements bevatten, dus het kan niet worden aangenomen dat SQL_SOPT_SS_NOCOUNT_STATUS constant blijft. Deze optie moet elke keer getest worden wanneer SQLRowCount 0 teruggeeft.

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

Het attribuut SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT geeft de berichttekst terug voor het querymeldingsverzoek.

SQLGetStmtAttr en tabelwaardige parameters

SQLGetStmtAttr kan worden aangeroepen om de waarde van SQL_SOPT_SS_PARAM_FOCUS in de applicatieparameterdescriptor (APD) te krijgen wanneer er met tabelwaardige parameters wordt gewerkt. Voor meer informatie over SQL_SOPT_SS_PARAM_FOCUS, zie SQLSetStmtAttr.

Voor meer informatie over tabelwaardige parameters, zie Table-Valued Parameters (ODBC).

Zie ook

SQLSetStmtAttr, functie
Details van ODBC-API-implementatie