SQLGetStmtAttr
Il driver ODBC di SQL Server Native Client estende SQLGetStmtAttr per esporre gli attributi di istruzione specifici del driver.
SQLSetStmtAttr elenca gli attributi di istruzione che sono sia in lettura sia in scrittura. In questo argomento vengono elencati gli attributi di istruzione in 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 riporta 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. SQLRowCount non restituisce il numero di righe interessate. 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, NOCOUNT è disattivato e il valore 0 di SQLRowCount indica che l'istruzione non ha influito sulle righe.
Quando SQL_SOPT_SS_NOCOUNT_STATUS è SQL_NC_OFF, le applicazioni non dovrebbero visualizzare il valore di SQLRowCount. 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
SQLGetStmtAttr può essere chiamato per ottenere il valore di SQL_SOPT_SS_PARAM_FOCUS nel descrittore di parametri dell'applicazione (APD) quando si utilizzano i parametri con valori di tabella. Per ulteriori informazioni su SQL_SOPT_SS_PARAM_FOCUS, vedere SQLSetStmtAttr.
Per ulteriori informazioni sui parametri con valori di tabella, vedere Parametri con valori di tabella (ODBC).
Cronologia modifiche
Aggiornamento del contenuto |
|---|
Rimozione degli attribuiti di istruzione di lettura e scrittura e aggiunta di informazioni sul tipo ValuePtr. |