SQLGetStmtAttr

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Az SQL Server Native Client ODBC illesztőprogramja kiterjeszti az SQLGetStmtAttr-t, hogy illesztőspecifikus utasítás attribútumokat tárjon ki.

Az SQLSetStmtAttr olyan mondattribútumokat listel, amelyek egyszerre olvasható, mind írnivaló. Ez a téma felsorolja az csak olvasott állítás attribútumokat.

SQL_SOPT_SS_CURRENT_COMMAND

A SQL_SOPT_SS_CURRENT_COMMAND attribútum feltárja a parancscsomag aktuális parancsát. A visszacsatolás egy egész szám, amely megadja a parancs helyét a batchben. A ValuePtr érték SQLLEN típusú.

SQL_SOPT_SS_NOCOUNT_STATUS

A SQL_SOPT_SS_NOCOUNT_STATUS attribútum az opció aktuális beállítását NOCOUNT jelzi, amely szabályozza, hogy SQL Server jelentése-e, hány sort érint egy utasítás, amikor SQLRowCount hívás történik. A ValuePtr érték SQLLEN típusú.

Value Description
SQL_NC_OFF NOCOUNT KI van kapcsolva. Az SQLRowCount az érintett sorok számát adja vissza.
SQL_NC_ON NOCOUNT BEKAPCSOL. Az érintett sorok számát nem adja vissza az SQLRowCount, és a visszaadott érték 0.

Ha az SQLRowCount 0-t ad vissza, az alkalmazásnak SQL_SOPT_SS_NOCOUNT_STATUS-t kell tesztelnie. Ha SQL_NC_ON visszaadják, az SQLRowCount 0 értéke csak azt jelzi, hogy SQL Server nem adott vissza sorszámot. Ha SQL_NC_OFF visszakerül, az azt jelenti, hogy NOCOUNT az nem működik, és az SQLRowCount 0 értéke azt jelzi, hogy az utasítás nem érintette egyetlen sort.

Az alkalmazásoknak nem szabad megjeleníteniük az SQLRowCount értékét, ha SQL_SOPT_SS_NOCOUNT_STATUS SQL_NC_OFF. Nagy tételek vagy tárolt eljárások több SET NOCOUNT állítást tartalmazhatnak, így nem feltételezhető, hogy SQL_SOPT_SS_NOCOUNT_STATUS állandó marad. Ezt az opciót minden alkalommal tesztelni kell, amikor az SQLRowCount 0-t ad vissza.

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

A SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT attribútum visszaadja az üzenet szövegét a lekérdezési értesítési kérelmhez.

SQLGetStmtAttr és táblázatértékű paraméterek

Az SQLGetStmtAttr meghívható, hogy megkapja az SQL_SOPT_SS_PARAM_FOCUS értékét az alkalmazásparaméter-leíróban (APD), amikor táblázatértékű paraméterekkel dolgozik. További információért SQL_SOPT_SS_PARAM_FOCUS lásd: SQLSetStmtAttr.

További információért a táblázatértékű paraméterekről lásd Table-Valued Paramétereket (ODBC).