SQLGetStmtAttr

Si applica a:SQL ServerDatabase SQL diAzure Istanzagestita di SQL di Azure Azure Synapse Analytics PlatformSystem (PDW)

Il driver ODBC di SQL Server Native Client estende SQLGetStmtAttr per esporre attributi di istruzione specifici del driver.

SQLSetStmtAttr elenca gli attributi dell'istruzione che sono sia di lettura che di scrittura. In questo argomento vengono elencati gli attributi dell'istruzione di sola lettura.

SQL_SOPT_SS_CURRENT_COMMAND

L'attributo SQL_SOPT_SS_CURRENT_COMMAND espone il comando corrente di un batch di comandi. Il valore restituito è un numero intero che specifica il percorso del comando nel batch. Il valore ValuePtr è di tipo SQLLEN.

SQL_SOPT_SS_NOCOUNT_STATUS

L'attributo SQL_SOPT_SS_NOCOUNT_STATUS indica l'impostazione corrente dell'opzione NOCOUNT, che controlla se SQL Server segnala i numeri di righe interessate da un'istruzione quando viene chiamato SQLRowCount . Il valore ValuePtr è di tipo SQLLEN.

Valore	Descrizione
SQL_NC_OFF	NOCOUNT è OFF. SQLRowCount restituisce il numero di righe interessate.
SQL_NC_ON	NOCOUNT è ON. Il numero di righe interessate non viene restituito da SQLRowCount e il valore restituito è 0.

Se SQLRowCount restituisce 0, l'applicazione deve testare SQL_SOPT_SS_NOCOUNT_STATUS. Se viene restituito SQL_NC_ON, il valore 0 di SQLRowCount indica solo che SQL Server non ha restituito un conteggio delle righe. Se viene restituito SQL_NC_OFF, significa che NOCOUNT è disattivato e il valore 0 da SQLRowCount indica che l'istruzione non ha effetto su alcuna riga.

Le applicazioni non devono visualizzare il valore di SQLRowCount quando SQL_SOPT_SS_NOCOUNT_STATUS è SQL_NC_OFF. Le stored procedure o i batch di grandi dimensioni possono contenere più istruzioni SET NOCOUNT, pertanto non è possibile presupporre che SQL_SOPT_SS_NOCOUNT_STATUS rimanga costante. Questa opzione deve essere testata ogni volta che SQLRowCount restituisce 0.

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

L'attributo SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT restituisce il testo del messaggio per la richiesta di notifica di query.

SQLGetStmtAttr e parametri con valori di tabella

È possibile chiamare SQLGetStmtAttr per ottenere il valore di SQL_SOPT_SS_PARAM_FOCUS nel descrittore del parametro dell'applicazione (APD) quando si utilizzano parametri con valori di tabella. Per altre informazioni su SQL_SOPT_SS_PARAM_FOCUS, vedere SQLSetStmtAttr.

Per altre informazioni sui parametri con valori di tabella, vedere Parametri con valori di tabella (ODBC).

Vedi anche

Funzione SQLSetStmtAttr
Dettagli di implementazione dell'API ODBC