SQLGetStmtAttr

Si applica a: SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di strumenti analitici (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'opzioneNOCOUNT, che controlla se SQL Server riporta il numero di righe interessate da un'istruzione quando viene chiamato SQLRowCount. Il valore ValuePtr è di tipo SQLLEN.

valore Descrizione
SQL_NC_OFF NOCOUNT è SPENTO. SQLRowCount restituisce il numero di righe interessate.
SQL_NC_ON NOCOUNT è ACCESO. 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 SQL_NC_OFF viene restituito, significa che NOCOUNT è spento e il valore di 0 da SQLRowCount indica che l'istruzione non ha influenzato nessuna riga.

Le applicazioni non devono visualizzare il valore di SQLRowCount quando SQL_SOPT_SS_NOCOUNT_STATUS è SQL_NC_OFF. Large batch o stored procedure possono contenere più SET NOCOUNT istruzioni, quindi non si può presumere che SQL_SOPT_SS_NOCOUNT_STATUS rimangano costanti. 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