SQLGetStmtAttr

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformní systém (PDW)

Nativní klientský ODBC ovladač SQL Server rozšiřuje SQLGetStmtAttr tak, aby zpřístupnil specifické atributy příkazu pro ovladač.

SQLSetStmtAttr uvádí atributy příkazů, které jsou zároveň čtené i zapisované. Toto téma uvádí atributy výroků pouze pro čtení.

SQL_SOPT_SS_CURRENT_COMMAND

Atribut SQL_SOPT_SS_CURRENT_COMMAND odhaluje aktuální příkaz příkazové dávky. Return je celé číslo, které určuje umístění příkazu v dávce. Hodnota ValuePtr je typu SQLLEN.

SQL_SOPT_SS_NOCOUNT_STATUS

Atribut SQL_SOPT_SS_NOCOUNT_STATUS označuje aktuální nastavení NOCOUNT volby, která řídí, zda SQL Server hlásí počet řádků ovlivněných příkazem při volání SQLRowCount. Hodnota ValuePtr je typu SQLLEN.

Value Description
SQL_NC_OFF NOCOUNT je VYPNUTÝ. SQLRowCount vrací počet ovlivněných řádků.
SQL_NC_ON NOCOUNT je zapnuté. Počet ovlivněných řádků není vrácen pomocí SQLRowCount a vrácená hodnota je 0.

Pokud SQLRowCount vrátí 0, aplikace by měla SQL_SOPT_SS_NOCOUNT_STATUS otestovat. Pokud je SQL_NC_ON vráceno, hodnota 0 ze SQLRowCount pouze znamená, že SQL Server nevrátil počet řádků. Pokud je SQL_NC_OFF vráceno, znamená to, že je to NOCOUNT mimo a hodnota 0 ze SQLRowCount naznačuje, že příkaz neovlivnil žádné řádky.

Aplikace by neměly zobrazovat hodnotu SQLRowCount, když je SQL_SOPT_SS_NOCOUNT_STATUS SQL_NC_OFF. Velké dávky nebo uložené procedury mohou obsahovat více SET NOCOUNT příkazů, takže nelze předpokládat, že SQL_SOPT_SS_NOCOUNT_STATUS zůstává konstantní. Tuto možnost by měla testovat pokaždé, když SQLRowCount vrátí 0.

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

Atribut SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT vrací text zprávy pro požadavek na oznámení dotazu.

SQLGetStmtAttr a tabulkové parametry

SQLGetStmtAttr lze volat pro získání hodnoty SQL_SOPT_SS_PARAM_FOCUS v aplikačním parametrovém deskriptoru (APD) při práci s tabulkovými parametry. Pro více informací o SQL_SOPT_SS_PARAM_FOCUS viz SQLSetStmtAttr.

Pro více informací o tabulkových parametrech viz Table-Valued Parametry (ODBC).

Viz také

FUNKCE SQLSetStmtAttr
Podrobnosti implementace rozhraní ODBC API