SQLSetConnectAttr

SQL_COPT_SS_ANSI_NPW

SQL_COPT_SS_ANSI_NPW Włącza lub wyłącza używanie ISO obsługa wartości NULL w porównania i łączenie, znaku typu danych, uzupełnienie i ostrzeżenia.Aby uzyskać więcej informacji zobacz zestaw ANSI_NULLS, zestaw ANSI_WARNINGS, zestaw ANSI_PADDING i CONCAT_NULL_YIELDS_NULL zestaw.

Jeśli korzystasz z puli połączeń, SQL_COPT_SS_ANSI_NPW powinna być ustawiona w ciąg połączenia, a nie z SQLSetConnectAttr. Po ustanowieniu połączenia, każda próba zmiany tego atrybut zakończy się niepowodzeniem dyskretnie podczas tworzenia i utrzymywania puli połączeń jest używana.

SQL_COPT_SS_ATTACHDBFILENAME

SQL_COPT_SS_ATTACHDBFILENAME Określa nazwę pliku podstawowego dołączanej bazy danych.Ta baza danych jest podłączony i staje się domyślna baza danych dla połączenia.Do używania SQL_COPT_SS_ATTACHDBFILENAME należy określić nazwę bazy danych jako wartość atrybut połączenia SQL_ATTR_CURRENT_CATALOG lub w bazie danych = parametr SQLDriverConnect.Jeśli wcześniej był przypisany w bazie danych, SQL Server nie będzie podłącz go.

SQL_COPT_SS_BCP

Włącza SQL_COPT_SS_BCP kopiowanie masowe funkcje dla połączenia.Aby uzyskać więcej informacji zobaczFunkcji kopiowania zbiorczej.

SQL_COPT_SS_BROWSE_CONNECT

Ten atrybut jest używany do dostosowywania zestaw wyników zwróconych przez SQLBrowseConnect.SQL_COPT_SS_BROWSE_CONNECT Włącza lub wyłącza zwrot dodatkowych informacji z wystąpienie tekstu stałego SQL Server. Może to być informacje, takie jak na to, czy serwer jest klaster, nazwy innego wystąpienia i numer wersja.

SQL_COPT_SS_BROWSE_SERVER

Ten atrybut jest używany do dostosowywania zestaw wyników zwróconych przez SQLBrowseConnect.SQL_COPT_SS_BROWSE_SERVER Określa nazwa serwera, dla którego SQLBrowseConnect zwraca informacje.

SQL_COPT_SS_CONCAT_NULL

SQL_COPT_SS_CONCAT_NULL Włącza lub wyłącza używanie ISO obsługa wartości NULL, podczas łączenia ciągów.Aby uzyskać więcej informacji zobacz zestaw CONCAT_NULL_YIELDS_NULL.

SQL_COPT_SS_ENCRYPT

Służy do sterowania szyfrowanie dla połączenia.

Certyfikat szyfrowanie jest używany na serwerze.To musi zostać zweryfikowana przez urząd certyfikacji, chyba że atrybut połączenia SQL_COPT_SS_TRUST_SERVER_CERTIFICATE zestaw SQL_TRUST_SERVER_CERTIFICATE_YES lub połączenia zawiera ciąg „ TrustServerCertificate = yes ".Jeśli spełniony jest jeden z tych warunków, certyfikatów, generowanych i podpisane przez serwer może służyć do szyfrowania połączenia, jeśli certyfikat nie znajduje się na serwerze.

SQL_COPT_SS_ENLIST_IN_DTC

Klient wywołuje bazie Microsoft transakcja rozproszona Coordinator (MS DTC) OLE danych ITransactionDispenser::BeginTransaction metoda, aby rozpocząć transakcję MS DTC i utworzyć obiekt transakcji MS DTC reprezentuje transakcji.Następnie aplikacja wywołuje SQLSetConnectAttr SQL_COPT_SS_ENLIST_IN_DTC umożliwia kojarzenie obiekt transakcji z połączenia ODBC.Wszystkie operacje powiązane bazy danych będą wykonywane w obszarze ochrony transakcji usługi MS DTC.Wywołania aplikacji SQLSetConnectAttr z SQL_DTC_DONE do zakończenia połączenia usługi skojarzenia.Aby uzyskać więcej informacji zobaczMS DTC Distributed Transactions.

SQL_COPT_SS_ENLIST_IN_XA

Aby rozpocząć transakcję XA z zgodny ze specyfikacją XA transakcji procesora (TP), klient wywołuje Open Group tx_begin funkcja.Następnie aplikacja wywołuje SQLSetConnectAttr parametr SQL_COPT_SS_ENLIST_IN_XA true, aby skojarzyć transakcji XA z połączenia ODBC.Wszystkie operacje powiązane bazy danych będą wykonywane zgodnie z ochrony transakcji XA.Aby zakończyć skojarzenie XA z połączenie ODBC, klient musi wywołać SQLSetConnectAttr parametr SQL_COPT_SS_ENLIST_IN_XA false.Aby uzyskać więcej informacji zobacz dokumentację koordynatora transakcja rozproszona firmy Microsoft.

SQL_COPT_SS_FALLBACK_CONNECT

Ten atrybut nie jest obsługiwany, ponieważ SQL Server Macierzysta klient nie obsługuje łączenia się z SQL Server 6.5.

SQL_COPT_SS_FAILOVER_PARTNER

Służy do określania lub pobrać nazwy partner pracy awaryjnej, używane do dublowanie w bazie danych SQL Server, a ciąg zerowy znaków zakończonych, które muszą być zestaw przed połączeniem SQL Server początkowo jest wykonywana.

Po dokonaniu połączenia, aplikacja może wysłać kwerendę za pomocą tego atrybut SQLGetConnectAttr ustalić tożsamości partner pracy awaryjnej.Jeśli serwer podstawowy nie ma awaryjnego partner tej właściwość będzie zwracać ciąg pusty.Dzięki temu, inteligentnych aplikacji do pamięci podręcznej najbardziej ostatnio określonej kopia zapasowa serwera, ale takie aplikacje, należy pamiętać, że informacje są aktualizowane tylko wtedy, gdy połączenie jest pierwszym lub zresetować, jeśli w puli i może stać się nieaktualne za długi czas połączenia.

Aby uzyskać więcej informacji zobaczZa pomocą modułach bazy danych.

SQL_COPT_SS_INTEGRATED_SECURITY

SQL_COPT_SS_INTEGRATED_SECURITY wymusza użycie uwierzytelnianie systemu Windows do sprawdzania poprawności dostępu na serwerze logowania.Gdy używane jest uwierzytelnianie systemu Windows, sterownik zignoruje identyfikatora użytkownika i hasło wartości w ramach SQLConnect, SQLDriverConnect, or SQLBrowseConnect przetwarzania.

SQL_COPT_SS_MARS_ENABLED

Ten atrybut Włącza lub wyłącza wiele zestawów wyników Active (MARS).Usługa MARS jest domyślnie wyłączone.Ten atrybut, należy ustawić przed wprowadzeniem połączenia SQL Server. Po połączeniu SQL Server jest otwarty, MARS pozostanie włączone lub wyłączone przez cały czas istnienia połączenia.

Aby uzyskać więcej informacji na temat serwera MARS Zobacz Za pomocą wielu wyników Active ustawia (MARS).

SQL_COPT_SS_OLDPWD

Wygaśnięcie hasła dla uwierzytelnianie programu SQL Server został wprowadzony w SQL Server 2005. Atrybut SQL_COPT_SS_OLDPWD został dodany do pozwalają klientowi zapewniające stare i nowe hasło dla połączenia.Gdy ta właściwość jest zestaw, dostawca nie będzie używać puli połączeń dla pierwszego połączenia lub następnych połączeń, ponieważ ciąg połączenia będzie zawierać “ starego hasła ” zostanie zmieniona.

Aby uzyskać więcej informacji zobaczProgramowe zmienianie hasła.

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA uruchamia lub zatrzymuje rejestrowanie danych dotyczących wydajności.Nazwa pliku dziennika dane muszą być zestaw przed do rozpoczęcia rejestrowania danych.Zobacz SQL_COPT_SS_PERF_DATA_LOG poniżej.

Aby uzyskać więcej informacji zobaczSQLGetConnectAttr.

SQL_COPT_SS_PERF_DATA_LOG

SQL_COPT_SS_PERF_DATA_LOG przypisuje nazwę pliku dziennika, używane do rejestrowania danych dotyczących wydajności.Nazwa pliku dziennika jest ANSI lub Unicode, w zależności od aplikacji kompilacji ciąg zakończony wartością zerową.The StringLength argument should be SQL_NTS.

SQL_COPT_SS_PERF_DATA_LOG_NOW

SQL_COPT_SS_PERF_DATA_LOG_NOW nakazuje sterownikowi zapisu dziennika statystyki na dysku.The StringLength argument should be SQL_NTS.

SQL_COPT_SS_PERF_QUERY

SQL_COPT_SS_PERF_QUERY uruchamianiu lub zatrzymywaniu rejestrowania długości uruchamianie kwerendy.Przed do rozpoczęcia rejestrowania należy podać nazwę pliku dziennika kwerendy.Aplikacja może definiować "długo działające" przez ustawienie interwału dla rejestrowania.

Aby uzyskać więcej informacji zobaczSQLGetConnectAttr.

SQL_COPT_SS_PERF_QUERY_INTERVAL

SQL_COPT_SS_PERF_QUERY_INTERVAL ustawia progu rejestrowania kwerend (w milisekundach).Kwerendy, które nie umożliwiają rozwiązania w ramach próg są rejestrowane w pliku dziennika długo działających kwerendy.Próg kwerendy jest nie górnego limitu.Zerowe wartości progu kwerendy powoduje rejestrowanie wszystkich kwerend.

SQL_COPT_SS_PERF_QUERY_LOG

SQL_COPT_SS_PERF_QUERY_LOG przypisuje nazwę pliku dziennika dla rejestrowania długo działających danych kwerendy.Nazwa pliku dziennika jest ANSI lub Unicode, w zależności od aplikacji kompilacji ciąg zakończony wartością zerową.The StringLength argument should be SQL_NTS.

SQL_COPT_SS_PRESERVE_CURSORS

Atrybut ten pozwala na kwerendy i ustawić niezależnie od tego, czy połączenie zachowa kursor(s), gdy użytkownik zatwierdzeń/wycofać transakcji.Ustawienie jest SQL_PC_ON lub SQL_PC_OFF.Wartość domyślna to SQL_PC_OFF.Ustawienie to kontroluje, niezależnie od tego, czy sterownik zostanie zamknięty kursor(s) automatycznie po połączeniu się z SQLEndTran (lub SQLTransact).

SQL_COPT_SS_QUOTED_IDENT

SQL_COPT_SS_QUOTED_IDENT umożliwia identyfikatorów w cudzysłowach w instrukcji języka Transact-SQL i ODBC przedstawionych w danym połączeniu.Dostarczając identyfikatorów w cudzysłowach, SQL ServerW przeciwnym razie umożliwia nieprawidłowy macierzysty sterownik ODBC klient nazwy, takie jak "Moje tabela", który zawiera znak spacji w identyfikatora obiektu. Aby uzyskać więcej informacji zobacz zestaw QUOTED_IDENTIFIER.

SQL_COPT_SS_TRANSLATE

SQL_COPT_SS_TRANSLATE powoduje, że sterownik do translacji znaków między klient a serwerem stron kodowych, jak MBCS dane są wymieniane.The attribute affects only data stored in SQL Serverchar, varchar, and text columns.

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE

SQL_COPT_SS_TRUST_SERVER_CERTIFICATE powoduje, że sterownik włączyć lub wyłączyć sprawdzanie poprawności certyfikat przy użyciu szyfrowanie.Ten atrybut jest wartością odczytu i zapisu, ale zostanie ustawiona po nawiązaniu połączenia nie da żadnego efektu.

Aplikacje klienckie mogą wysyłać kwerendy tej właściwość po otwarciu połączenia do określenia rzeczywistego ustawienia szyfrowanie i sprawdzania poprawności w użyciu.

SQL_COPT_SS_TXN_ISOLATION

Zestawy SQL_COPT_SS_TXN_ISOLATION SQL Server atrybut izolacji określonych migawka. migawka izolacji nie zestaw przy użyciu SQL_ATTR_TXN_ISOLATION, ponieważ wartość jest SQL Server określone. Jednak mogą być pobierane, za pomocą SQL_ATTR_TXN_ISOLATION lub SQL_COPT_SS_TXN_ISOLATION.

Aby uzyskać więcej informacji na temat migawka izolacji zobacz Praca z izolacji migawka.

SQL_COPT_SS_USE_PROC_FOR_PREP

Ten atrybut nie jest obsługiwany, ponieważ SQL Server Macierzysta klient nie obsługuje łączenia się z SQL Server 6.5.

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA ustawia wskaźnik danych użytkownika.Dane użytkownika są własnością klient pamięci rejestrowane na połączenie.

Aby uzyskać więcej informacji zobaczSQLGetConnectAttr.

SQL_COPT_SS_WARN_ON_CP_ERROR

Jeśli ten atrybut jest zestaw do SQL_WARN_YES, zostanie wyświetlone ostrzeżenie, jeżeli występuje utrata danych podczas konwersji strona do kodu.Dotyczy to tylko na danych pochodzących z serwera.

SQL_WARN_NO Wyłącza ostrzeżenie.

Obsługa SQLSetConnectAttr główne nazwy usług (SPN)

SQLSetConnectAttr zestaw wartości nowych atrybutów połączenia SQL_COPT_SS_SERVER_SPN i SQL_COPT_SS_FAILOVER_PARTNER_SPN.Nie zestaw te atrybuty, jeśli połączenie jest otwarte, jeżeli spróbujesz ustawić te atrybuty, gdy połączenie jest otwarte, HY011 zwracany jest błąd z komunikatem "Operacja nieprawidłowa w tej chwili".(SQLSetConnectOption można również ustawić te wartości.)

Aby uzyskać więcej informacji na temat nazwy SPN zobacz Główne nazwy usług (SPN) w oknie klient połączenia (ODBC).

SQL_COPT_SS_CONNECTION_DEAD

Jest to atrybut tylko do odczytu.

Aby uzyskać więcej informacji na temat SQL_COPT_SS_CONNECTION_DEAD zobacz SQLGetConnectAttr i Łączenie ze źródłem danych (ODBC).

Przykład

W tym przykładzie rejestruje dane dotyczące wydajności.

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...

Historia zmian

See Also

Reference

Concepts

Other Resources