SQLGetConnectAttr

Il driver ODBC di SQL Server Native Client definisce gli attributi di connessione specifici del driver. Alcuni degli attributi sono disponibili in SQLGetConnectAttr e la funzione viene utilizzata per segnalare le impostazioni correnti. I valori segnalati per questi attributi sono garantiti solo dopo aver effettuato una connessione o dopo aver impostato l'attributo utilizzando SQLSetConnectAttr.

In questo argomento sono elencati gli attributi di sola lettura. Per informazioni sugli altri attributi di connessione specifici del driver ODBC di SQL Server Native Client, vedere SQLSetConnectAttr.

SQL_COPT_SS_CONNECTION_DEAD

L'attributo SQL_COPT_SS_CONNECTION_DEAD consente di segnalare lo stato di una connessione a un server. Il driver esegue query sulla rete al fine di individuare lo stato corrente della connessione.

[!NOTA]

L'attributo di connessione ODBC standard SQL_COPT_SS_CONNECTION_DEAD restituisce lo stato più recente della connessione. Tale stato potrebbe non essere quello corrente.

SQL_COPT_SS_CLIENT_CONNECTION_ID

L'attributo SQL_COPT_SS_CLIENT_CONNECTION_ID consente di recuperare l'ID di connessione client che può essere utilizzato per individuare:

• Informazioni di diagnostica nel registro XEvents, se abilitato.

• Informazioni sull'errore di connessione nel buffer circolare della connessione.

• Informazioni di diagnostica nei registri di traccia di accesso ai dati, se abilitati.

Per ulteriori informazioni, vedere Accesso alle informazioni di diagnostica nel registro eventi estesi.

SQL_COPT_SS_PERF_DATA

Tramite l'attributo SQL_COPT_SS_PERF_DATA viene restituito un puntatore a una struttura SQLPERF contenente le statistiche correnti sulle prestazioni del driver. SQLGetConnectAttr restituirà NULL se la registrazione delle prestazioni non è abilitata. Le statistiche nella struttura SQLPERF non vengono aggiornate in modo dinamico dal driver. Chiamare SQLGetConnectAttr ogni volta che è necessario aggiornare le statistiche sulle prestazioni.

SQL_COPT_SS_PERF_QUERY

L'attributo SQL_COPT_SS_PERF_QUERY restituisce TRUE se è abilitata la registrazione di query con esecuzione prolungata. La richiesta restituisce FALSE se la registrazione delle query non è attiva.

SQL_COPT_SS_USER_DATA

L'attributo SQL_COPT_SS_USER_DATA recupera il puntatore ai dati utente. I dati utente vengono archiviati nella memoria del client e registrati per singola connessione. Se il puntatore ai dati utente SQL_UD_NOTSET non è stato impostato, viene restituito un puntatore NULL.

Supporto di SQLSetConnectAttr per i nomi SPN (Service Principal Names)

È possibile utilizzare SQLGetConnectAttr per eseguire una query sul valore dei nuovi attributi di connessione SQL_COPT_SS_SERVER_SPN, SQL_COPT_SS_FAILOVER_PARTNER_SPN, SQL_COPT_SS_MUTUALLY_AUTHENTICATED e SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD. Per eseguire una query su questi valori, è possibile utilizzare anche SQLGetConnectOption.

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD è disponibile solo per connessioni aperte che utilizzano l'autenticazione di Windows.

Se non è stato impostato SQL_COPT_SS_SERVER_SPN o SQL_COPT_SS_FAILOVER_PARTNER, viene restituito il valore predefinito (una stringa vuota).

Per ulteriori informazioni sui nomi SPN, vedere Nomi SPN (Service Principal Name) nelle connessioni client (ODBC).

Vedere anche

Riferimento

SET QUOTED_IDENTIFIER (Transact-SQL)

SET ANSI_NULLS (Transact-SQL)

SET ANSI_PADDING (Transact-SQL)

SET ANSI_WARNINGS (Transact-SQL)

Concetti

Dettagli di implementazione di API ODBC

Altre risorse

Funzione SQLSetConnectAttr