SQLSetConnectAttr
Il driver ODBC SQL Server Native Client ignora l'impostazione di SQL_ATTR_CONNECTION_TIMEOUT.
SQL_ATTR_TRANSLATE_LIB viene inoltre ignorato. La specifica di un'altra libreria di conversione non è supportata. Per consentire alle applicazioni di essere facilmente convertite per usare un driver ODBC Microsoft per SQL Server, qualsiasi valore impostato con SQL_ATTR_TRANSLATE_LIB verrà copiato in e fuori da un buffer in Gestione driver.
Il driver ODBC SQL Server Native Client implementa l'isolamento delle transazioni di lettura ripetibile come serializzabile.
SQL Server 2005 ha introdotto il supporto per un nuovo attributo di isolamento delle transazioni, SQL_COPT_SS_TXN_ISOLATION. Impostando SQL_COPT_SS_TXN_ISOLATION su SQL_TXN_SS_SNAPSHOT si indica che la transazione si verificherà con il livello di isolamento dello snapshot.
Nota
SQL_ATTR_TXN_ISOLATION può essere utilizzato per impostare tutti gli altri livelli di isolamento ad eccezione di SQL_TXN_SS_SNAPSHOT. Se si desidera utilizzare l'isolamento dello snapshot, è necessario impostare SQL_TXN_SS_SNAPSHOT tramite SQL_COPT_SS_TXN_ISOLATION. Tuttavia, è possibile recuperare il livello di isolamento tramite SQL_ATTR_TXN_ISOLATION oppure SQL_COPT_SS_TXN_ISOLATION.
La promozione di attributi di istruzione ODBC ad attributi di connessione può comportare conseguenze impreviste. Gli attributi di istruzione che richiedono cursori del server per l'elaborazione dei set di risultati possono essere promossi ad attributi di connessione. L'impostazione, ad esempio, dell'attributo di istruzione ODBC SQL_ATTR_CONCURRENCY su un valore più restrittivo del valore predefinito SQL_CONCUR_READ_ONLY indica al driver di utilizzare cursori dinamici per tutte le istruzioni eseguite nella connessione. L'esecuzione di una funzione di catalogo ODBC in un'istruzione nella connessione restituisce SQL_SUCCESS_WITH_INFO e un record di diagnostica indicante che il comportamento del cursore è stato modificato e impostato come di sola lettura. Un tentativo di esecuzione di un'istruzione Transact-SQL SELECT contenente una clausola COMPUTE nella stessa connessione avrà esito negativo.
Il driver ODBC SQL Server Native Client supporta numerose estensioni specifiche del driver per gli attributi di connessione ODBC definiti in sqlncli.h. Il driver ODBC SQL Server Native Client può richiedere che l'attributo sia impostato prima della connessione oppure può ignorare l'attributo se è già impostato. Nella tabella seguente sono incluse le restrizioni.
| Attributo di SQL Server | Impostazione prima o dopo la connessione al server |
|---|---|
| SQL_COPT_SS_ANSI_NPW | Prima |
| SQL_COPT_SS_APPLICATION_INTENT | Prima |
| SQL_COPT_SS_ATTACHDBFILENAME | Prima |
| SQL_COPT_SS_BCP | Prima |
| SQL_COPT_SS_BROWSE_CONNECT | Prima |
| SQL_COPT_SS_BROWSE_SERVER | Prima |
| SQL_COPT_SS_CONCAT_NULL | Prima |
| SQL_COPT_SS_CONNECTION_DEAD | After |
| SQL_COPT_SS_ENCRYPT | Prima |
| SQL_COPT_SS_ENLIST_IN_DTC | After |
| SQL_COPT_SS_ENLIST_IN_XA | After |
| SQL_COPT_SS_FALLBACK_CONNECT | Prima |
| SQL_COPT_SS_FAILOVER_PARTNER | Prima |
| SQL_COPT_SS_INTEGRATED_SECURITY | Prima |
| SQL_COPT_SS_MARS_ENABLED | Prima |
| SQL_COPT_SS_MULTISUBMIT_FAILOVER | Prima |
| SQL_COPT_SS_OLDPWD | Prima |
| SQL_COPT_SS_PERF_DATA | After |
| SQL_COPT_SS_PERF_DATA_LOG | After |
| SQL_COPT_SS_PERF_DATA_LOG_NOW | After |
| SQL_COPT_SS_PERF_QUERY | After |
| SQL_COPT_SS_PERF_QUERY_INTERVAL | After |
| SQL_COPT_SS_PERF_QUERY_LOG | After |
| SQL_COPT_SS_PRESERVE_CURSORS | Prima |
| SQL_COPT_SS_QUOTED_IDENT | Prima o dopo |
| SQL_COPT_SS_TRANSLATE | Prima o dopo |
| SQL_COPT_SS_TRUST_SERVER_CERTIFICATE | Prima |
| SQL_COPT_SS_TXN_ISOLATION | Prima o dopo |
| SQL_COPT_SS_USE_PROC_FOR_PREP | Prima o dopo |
| SQL_COPT_SS_USER_DATA | Prima o dopo |
| SQL_COPT_SS_WARN_ON_CP_ERROR | Prima |
L'uso di un attributo di pre-connessione e del comando Transact-SQL equivalente per la stessa sessione, database o SQL Server stato può generare un comportamento imprevisto. Ad esempio,
SQLSetConnectAttr(SQL_COPT_SS_QUOTED_IDENT, SQL_QI_ON) // turn ON via attribute
SQLDriverConnect(...);
SQLExecDirect("SET QUOTED_IDENTIFIER OFF") // turn OFF via Transact-SQL
SQLSetConnectAttr(SQL_ATTR_CURRENT_CATALOG, ...) // restores to pre-connect attribute value
SQL_COPT_SS_ANSI_NPW
SQL_COPT_SS_ANSI_NPW abilita o disabilita l'utilizzo della gestione ISO di valori NULL nei confronti e nella concatenazione, nella spaziatura dei tipi di dati character e negli avvisi. Per ulteriori informazioni, vedere SET ANSI_NULLS, SET ANSI_PADDING, SET ANSI_WARNINGS e SET CONCAT_NULL_YIELDS_NULL.
| Valore | Descrizione |
|---|---|
| SQL_AD_ON | Valore predefinito. La connessione utilizza il comportamento ANSI predefinito per la gestione dei confronti di valori NULL, per il riempimento, gli avvisi e le concatenazioni NULL. |
| SQL_AD_OFF | La connessione usa SQL Server gestione definita da NULL, riempimento dei tipi di dati carattere e avvisi. |
Se si usa il pool di connessioni, SQL_COPT_SS_ANSI_NPW deve essere impostato nella stringa di connessione anziché con SQLSetConnectAttr. Una volta stabilita una connessione, qualsiasi tentativo di modifica di questo attributo avrà esito negativo senza generare alcun avviso quando si utilizza un pool di connessioni.
SQL_COPT_SS_APPLICATION_INTENT
Dichiara il tipo di carico di lavoro dell'applicazione in caso di connessione a un server. I valori possibili sono Readonly e ReadWrite. Ad esempio:
SQLSetConnectAttr(hdbc, SQL_COPT_SS_APPLICATION_INTENT, TEXT("Readonly"), SQL_NTS)
Il valore predefinito è ReadWrite. Per altre informazioni sul supporto di SQL Server Native Client per i gruppi di disponibilità di Always On, vedere SQL Server Native Client Supporto per disponibilità elevata e ripristino di emergenza.
SQL_COPT_SS_ATTACHDBFILENAME
SQL_COPT_SS_ATTACHDBFILENAME specifica il nome del file primario di un database collegabile. Questo database viene collegato e diventa il database predefinito per la connessione. Per usare SQL_COPT_SS_ATTACHDBFILENAME è necessario specificare il nome del database come valore dell'attributo di connessione SQL_ATTR_CURRENT_CATALOG o nel parametro DATABASE = di sqlDriverConnect. Se il database è stato collegato in precedenza, SQL Server non lo ricollega.
| Valore | Descrizione |
|---|---|
| SQLPOINTER a una stringa di caratteri | La stringa contiene il nome del file primario per il database da collegare. Includere il percorso completo del file. |
SQL_COPT_SS_BCP
SQL_COPT_SS_BCP consente funzioni di copia bulk in una connessione. Per altre informazioni, vedere Funzioni di copia bulk.
| Valore | Descrizione |
|---|---|
| SQL_BCP_OFF | Valore predefinito. Le funzioni di copia bulk non sono disponibili nella connessione. |
| SQL_BCP_ON | Le funzioni di copia bulk sono disponibili nella connessione. |
SQL_COPT_SS_BROWSE_CONNECT
Questo attributo viene usato per personalizzare il set di risultati restituito da SQLBrowseConnect. SQL_COPT_SS_BROWSE_CONNECT abilita o disabilita la restituzione di informazioni aggiuntive da un'istanza enumerata di SQL Server. Tali informazioni possono includere l'indicazione che il server è o non è un cluster, i nomi di diverse istanze e il numero di versione.
| Valore | Descrizione |
|---|---|
| SQL_MORE_INFO_NO | Valore predefinito. Restituisce un elenco di server. |
| SQL_MORE_INFO_YES | SQLBrowseConnect restituisce una stringa estesa di proprietà del server. |
SQL_COPT_SS_BROWSE_SERVER
Questo attributo viene usato per personalizzare il set di risultati restituito da SQLBrowseConnect. SQL_COPT_SS_BROWSE_SERVER specifica il nome del server per il quale SQLBrowseConnect restituisce le informazioni.
| Valore | Descrizione |
|---|---|
| nomecomputer | SQLBrowseConnect restituisce un elenco di istanze di SQL Server nel computer specificato. Per il nome del server non devono essere utilizzate le barre rovesciate doppie (\\). Ad esempio, invece di \\MyServer, deve essere utilizzato MyServer. |
| NULL | Valore predefinito. SQLBrowseConnect restituisce informazioni per tutti i server nel dominio. |
SQL_COPT_SS_CONCAT_NULL
SQL_COPT_SS_CONCAT_NULL abilita o disabilita l'utilizzo della gestione ISO di valori NULL per la concatenazione delle stringhe. Per ulteriori informazioni, vedere SET CONCAT_NULL_YIELDS_NULL.
| Valore | Descrizione |
|---|---|
| SQL_CN_ON | Valore predefinito. La connessione utilizza il comportamento predefinito ISO per la gestione di valori NULL per la concatenazione delle stringhe. |
| SQL_CN_OFF | La connessione usa SQL Server comportamento definito per la gestione dei valori NULL durante la concatenazione di stringhe. |
SQL_COPT_SS_ENCRYPT
Controlla la crittografia per una connessione.
Per la crittografia viene utilizzato il certificato del server. Tale certificato deve essere verificato da un autorità di certificazione, a meno che l'attributo di connessione SQL_COPT_SS_TRUST_SERVER_CERTIFICATE venga impostato su SQL_TRUST_SERVER_CERTIFICATE_YES o la stringa di connessione contenga "TrustServerCertificate=yes". Se si verifica una di queste condizioni, un certificato generato e firmato dal server può essere utilizzato per crittografare la connessione se nel server non è presente alcun certificato.
| Valore | Descrizione |
|---|---|
| SQL_EN_ON | La connessione verrà crittografata. |
| SQL_EN_OFF | La connessione non verrà crittografata. Questo è il valore predefinito. |
SQL_COPT_SS_ENLIST_IN_DTC
Il client chiama il metodo MICROSOFT Distributed Transaction Coordinator (MS DTC) OLE DB ITransactionDispenser::BeginTransaction per avviare una transazione MS DTC e creare un oggetto transazione MS DTC che rappresenta la transazione. L'applicazione chiama SQLSetConnectAttr quindi con l'opzione SQL_COPT_SS_ENLIST_IN_DTC per associare l'oggetto transazione alla connessione ODBC. Tutte le attività del database correlate verranno eseguite sotto la protezione della transazione MS DTC. L'applicazione chiama SQLSetConnectAttr con SQL_DTC_DONE per terminare l'associazione DTC della connessione.
| Valore | Descrizione |
|---|---|
| Oggetto DTC* | Oggetto transazione OLE MS DTC che specifica la transazione da esportare in SQL Server. |
| SQL_DTC_DONE | Delimita la fine di una transazione DTC. |
SQL_COPT_SS_ENLIST_IN_XA
Per avviare una transazione XA con un processore di transazioni compatibile con XA, il client chiama la funzione di tx_begin open group. L'applicazione chiama SQLSetConnectAttr quindi con un parametro SQL_COPT_SS_ENLIST_IN_XA di TRUE per associare la transazione XA alla connessione ODBC. Tutte le attività del database correlate verranno eseguite sotto la protezione della transazione XA. Per terminare un'associazione XA con una connessione ODBC, il client deve chiamare SQLSetConnectAttr con un parametro SQL_COPT_SS_ENLIST_IN_XA false. Per ulteriori informazioni, vedere la documentazione di Microsoft Distributed Transaction Coordinator.
SQL_COPT_SS_FALLBACK_CONNECT
Questo attributo non è più supportato.
SQL_COPT_SS_FAILOVER_PARTNER
Consente di specificare o recuperare il nome del partner di failover usato per il mirroring del database in SQL Server e si tratta di una stringa di caratteri con terminazione Null che deve essere impostata prima che venga stabilita la connessione a SQL Server inizialmente.
Dopo aver stabilito la connessione, l'applicazione può eseguire una query su questo attributo usando SQLGetConnectAttr per determinare l'identità del partner di failover. Se il server primario non dispone di partner di failover, la proprietà restituirà una stringa vuota. In questo modo, un'applicazione smart può memorizzare nella cache il server di backup determinato più di recente, benché con tali applicazioni sia necessario tenere conto del fatto che le informazioni vengono aggiornate solo quando la connessione viene stabilita per la prima volta (o reimpostata, se in pool) e possono diventare obsolete nel caso di connessioni prolungate.
Per altre informazioni, vedere Uso del mirroring del database.
SQL_COPT_SS_INTEGRATED_SECURITY
SQL_COPT_SS_INTEGRATED_SECURITY forza l'utilizzo dell'autenticazione di Windows per la convalida dell'accesso in fase di connessione al server. Quando viene usata l'autenticazione di Windows, il driver ignora i valori di identificatore utente e password forniti come parte dell'elaborazione SQLConnect, SQLDriverConnect o SQLBrowseConnect .
| Valore | Descrizione |
|---|---|
| SQL_IS_OFF | Valore predefinito. SQL Server L'autenticazione viene usata per convalidare l'identificatore utente e la password nell'account di accesso. |
| SQL_IS_ON | La modalità di autenticazione di Windows viene usata per convalidare i diritti di accesso di un utente al SQL Server. |
SQL_COPT_SS_MARS_ENABLED
Questo attributo abilita o disabilita MARS (Multiple Active Result Set). Per impostazione predefinita, MARS è disabilitato. Questo attributo deve essere impostato prima di effettuare una connessione a SQL Server. Una volta aperta la connessione SQL Server, MARS rimarrà abilitata o disabilitata per la vita della connessione.
| Valore | Descrizione |
|---|---|
| SQL_MARS_ENABLED_NO | Valore predefinito. MARS è disabilitato. |
| SQL_MARS_ENABLED_YES | MARS è abilitato. |
Per altre informazioni su MARS, vedere Uso di più set di risultati attivi (MARS).
SQL_COPT_SS_MULTISUBNET_FAILOVER
Se l'applicazione si connette a un gruppo di disponibilità Always On gruppi di disponibilità (AG) in subnet diverse, questa proprietà di connessione configura SQL Server Native Client per fornire un rilevamento più veloce di e connessione al server attivo (attualmente). Ad esempio:
SQLSetConnectAttr(hdbc, SQL_COPT_SS_MULTISUBMIT_FAILOVER, SQL_IS_ON, SQL_IS_INTEGER)
Per altre informazioni sul supporto di SQL Server Native Client per i gruppi di disponibilità di Always On, vedere SQL Server Native Client supporto per disponibilità elevata, ripristino di emergenza.
| Valore | Descrizione |
|---|---|
| SQL_IS_ON | SQL Server Native Client fornisce una riconnessione più veloce se è presente un failover. |
| SQL_IS_OFF | SQL Server Native Client non fornirà una riconnessione più veloce se è presente un failover. |
SQL_COPT_SS_OLDPWD
In SQL Server 2005 è stata introdotta la scadenza della password per l'autenticazione di SQL Server. L'attributo SQL_COPT_SS_OLDPWD è stato aggiunto per consentire al client di fornire sia la vecchia password che la nuova per la connessione. Quando questa proprietà è impostata, il provider non utilizzerà il pool di connessioni per la prima connessione o per le connessioni successive, in quanto la stringa di connessione conterrà la password precedente che è stata modificata.
Per altre informazioni, vedere Modifica delle password a livello di programmazione.
| Valore | Descrizione |
|---|---|
| SQL_COPT_SS_OLD_PASSWORD | SQLPOINTER a una stringa di caratteri contenente la password precedente. Questo valore è di sola scrittura e deve essere impostato prima della connessione al server. |
SQL_COPT_SS_PERF_DATA
SQL_COPT_SS_PERF_DATA avvia o arresta la registrazione dei dati relativi alle prestazioni. Il nome del file di log deve essere impostato prima di avviare la registrazione dei dati. Vedere SQL_COPT_SS_PERF_DATA_LOG di seguito.
| Valore | Descrizione |
|---|---|
| SQL_PERF_START | Avvia il driver che esegue il campionamento dei dati relativi alle prestazioni. |
| SQL_PERF_STOP | Arresta il campionamento dei dati relativi alle prestazioni da parte dei contatori. |
Per altre informazioni, vedere SQLGetConnectAttr.
SQL_COPT_SS_PERF_DATA_LOG
SQL_COPT_SS_PERF_DATA_LOG assegna il nome del file di log utilizzato per registrare i dati relativi alle prestazioni. Il nome del file di log è una stringa ANSI o Unicode con terminazione Null che dipende dalla compilazione dell'applicazione. L'argomento StringLength deve essere SQL_NTS.
SQL_COPT_SS_PERF_DATA_LOG_NOW
SQL_COPT_SS_PERF_DATA_LOG_NOW indica al driver di scrivere una voce del log delle statistiche sul disco. L'argomento StringLength deve essere SQL_NTS.
SQL_COPT_SS_PERF_QUERY
SQL_COPT_SS_PERF_QUERY avvia o arresta la registrazione di query con esecuzione prolungata. Il nome del file di log delle query deve essere specificato prima di avviare la registrazione. L'applicazione può definire l'esecuzione prolungata impostando l'intervallo per la registrazione.
| Valore | Descrizione |
|---|---|
| SQL_PERF_START | Avvia la registrazione di query con esecuzione prolungata. |
| SQL_PERF_STOP | Arresta la registrazione di query con esecuzione prolungata. |
Per altre informazioni, vedere SQLGetConnectAttr.
SQL_COPT_SS_PERF_QUERY_INTERVAL
SQL_COPT_SS_PERF_QUERY_INTERVAL imposta la soglia di registrazione delle query in millisecondi. Le query che non vengono risolte entro la soglia vengono registrate nel file di log delle query con esecuzione prolungata. Non sussiste alcun limite per la soglia massima di query. Un valore soglia pari a zero comporta la registrazione di tutte le query.
SQL_COPT_SS_PERF_QUERY_LOG
SQL_COPT_SS_PERF_QUERY_LOG assegna il nome di un file di log per la registrazione dei dati delle query con esecuzione prolungata. Il nome del file di log è una stringa ANSI o Unicode con terminazione Null che dipende dalla compilazione dell'applicazione. L'argomento StringLength deve essere SQL_NTS o la lunghezza della stringa in byte.
SQL_COPT_SS_PRESERVE_CURSORS
Questo attributo consente di eseguire query per determinare se la connessione manterrà i cursori durante il commit o il rollback di una transazione e di impostare o meno tale comportamento. L'impostazione è SQL_PC_ON o SQL_PC_OFF. Il valore predefinito è SQL_PC_OFF. Questa impostazione controlla se il driver chiuderà i cursori quando si chiama SQLEndTran (o SQLTransact).
| Valore | Descrizione |
|---|---|
| SQL_PC_OFF | Valore predefinito. I cursori vengono chiusi quando la transazione viene eseguito il commit o il rollback usando SQLEndTran. |
| SQL_PC_ON | I cursori non vengono chiusi quando la transazione viene eseguito il commit o il rollback usando SQLEndTran, tranne quando si usa un cursore statico o keyset in modalità asincrona. Se si esegue un rollback quando il popolamento del cursore non è completo, il cursore viene chiuso. |
SQL_COPT_SS_QUOTED_IDENT
SQL_COPT_SS_QUOTED_IDENT consente la presenza di identificatori tra virgolette in istruzioni ODBC e Transact-SQL eseguite nella connessione. Fornendo identificatori virgolette, il driver ODBC SQL Server Native Client consente nomi di oggetti altrimenti non validi, ad esempio "Tabella personale", che contiene un carattere di spazio nell'identificatore. Per ulteriori informazioni, vedere SET QUOTED_IDENTIFIER.
| Valore | Descrizione |
|---|---|
| SQL_QI_OFF | La connessione SQL Server non consente identificatori con virgolette nell'oggetto Transact-SQL inviato. |
| SQL_QI_ON | Valore predefinito. La connessione consente identificatori virgolette in Transact-SQL inviati. |
SQL_COPT_SS_TRANSLATE
SQL_COPT_SS_TRANSLATE fa in modo che il driver converta caratteri tra le tabelle codici del client e del server durante lo scambio di dati MBCS. L'attributo influisce solo sui dati archiviati nelle colonne di testo SQL Server char, varchar e text.
| Valore | Descrizione |
|---|---|
| SQL_XL_OFF | Il driver non converte i caratteri da una tabella codici all'altra nei dati di tipo carattere scambiati tra il client e il server. |
| SQL_XL_ON | Valore predefinito. Il driver converte caratteri da una tabella codici a un'altra in dati di tipo carattere scambiati tra il client e il server. Il driver configura automaticamente la conversione dei caratteri, determinando la tabella codici installata nel server e quella utilizzata dal client. |
SQL_COPT_SS_TRUST_SERVER_CERTIFICATE
SQL_COPT_SS_TRUST_SERVER_CERTIFICATE fa in modo che il driver abiliti o disabiliti la convalida del certificato quando si utilizza la crittografia. Questo attributo è un valore di lettura/scrittura, ma non ha alcun effetto se lo si imposta una volta stabilita una connessione.
Le applicazioni client possono eseguire query su questa proprietà dopo l'apertura di una connessione per determinare le effettive impostazioni di crittografia e convalida in uso.
| Valore | Descrizione |
|---|---|
| SQL_TRUST_SERVER_CERTIFICATE_NO | Valore predefinito. La crittografia senza convalida del certificato non è abilitata. |
| SQL_TRUST_SERVER_CERTIFICATE_YES | La crittografia senza convalida del certificato è abilitata. |
SQL_COPT_SS_TXN_ISOLATION
SQL_COPT_SS_TXN_ISOLATION imposta l'attributo di isolamento dello snapshot specifico SQL Server. L'isolamento dello snapshot non può essere impostato usando SQL_ATTR_TXN_ISOLATION perché il valore è SQL Server specifico. Tale valore può tuttavia essere recuperato utilizzando SQL_ATTR_TXN_ISOLATION o SQL_COPT_SS_TXN_ISOLATION.
| Valore | Descrizione |
|---|---|
| SQL_TXN_SS_SNAPSHOT | Indica che non è possibile visualizzare da una transazione le modifiche apportate in altre transazioni e che ciò non è possibile neanche ripetendo la query. |
Per altre informazioni sull'isolamento dello snapshot, vedere Uso dell'isolamento snapshot.
SQL_COPT_SS_USE_PROC_FOR_PREP
Questo attributo non è più supportato.
SQL_COPT_SS_USER_DATA
SQL_COPT_SS_USER_DATA consente di impostare il puntatore ai dati dell'utente. I dati dell'utente vengono registrati nella memoria di proprietà del client per ogni connessione.
Per altre informazioni, vedere SQLGetConnectAttr.
SQL_COPT_SS_WARN_ON_CP_ERROR
Questo attributo determina la visualizzazione o meno di un avviso in caso di perdita di dati durante la conversione di una tabella codici. Si applica solo ai dati provenienti dal server.
| Valore | Descrizione |
|---|---|
| SQL_WARN_YES | Genera avvisi quando si verifica una perdita di dati durante la conversione della tabella codici. |
| SQL_WARN_NO | (Impostazione predefinita) Non genera avvisi quando si verifica una perdita di dati durante la conversione della tabella codici. |
Supporto di SQLSetConnectAttr per nomi SPN (Service Principal Name)
SQLSetConnectAttr può essere usato per impostare il valore dei nuovi attributi di connessione SQL_COPT_SS_SERVER_SPN e SQL_COPT_SS_FAILOVER_PARTNER_SPN. Tali attributi non possono essere impostati quando una connessione è aperta; se si tenta di impostare questi attributi quando una connessione è aperta, viene restituito l'errore HY011 con il messaggio "Operazione correntemente non valida". È anche possibile usare SQLSetConnectOption per impostare questi valori.
Per altre informazioni sugli SPN, vedere Nomi entità servizio (SPN) in Connessioni client (ODBC).
SQL_COPT_SS_CONNECTION_DEAD
Attributo di sola lettura.
Per altre informazioni su SQL_COPT_SS_CONNECTION_DEAD, vedere SQLGetConnectAttr e Connessione a un'origine dati (ODBC).
Esempio
In questo esempio vengono registrati i dati relativi alle prestazioni.
SQLPERF* pSQLPERF;
SQLINTEGER nValue;
// See if you are already logging. SQLPERF* will be NULL if not.
SQLGetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA, &pSQLPERF,
sizeof(SQLPERF*), &nValue);
if (pSQLPERF == NULL)
{
// Set the performance log file name.
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG,
(SQLPOINTER) "\\My LogDirectory\\MyServerLog.txt", SQL_NTS);
// Start logging...
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,
(SQLPOINTER) SQL_PERF_START, SQL_IS_INTEGER);
}
else
{
// Take a snapshot now so that your performance statistics are discernible.
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);
}
// ...perform some action...
// ...take a performance data snapshot...
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);
// ...perform more actions...
// ...take another snapshot...
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA_LOG_NOW, NULL, 0);
// ...and disable logging.
SQLSetConnectAttr(hDbc, SQL_COPT_SS_PERF_DATA,
(SQLPOINTER) SQL_PERF_STOP, SQL_IS_INTEGER);
// Continue on...
Vedere anche
Pagina relativa alla funzione SQLSetConnectAttr
Dettagli di implementazione dell'API ODBC
Funzioni di copia bulk
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
SET CONCAT_NULL_YIELDS_NULL (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
Pagina relativa alla funzione SQLPrepare
SQLGetInfo