Поделиться через


Свойства инициализации и авторизации

Поставщик OLE DB собственного клиента SQL Server интерпретирует свойства инициализации и авторизации OLE DB следующим образом:

Идентификатор объекта недвижимости Описание
DBPROP_AUTH_CACHE_AUTHINFO Поставщик OLE DB собственного клиента SQL Server не кэширует сведения о проверке подлинности.

Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_ENCRYPT_PASSWORD Поставщик OLE DB собственного клиента SQL Server использует стандартные механизмы безопасности MicrosoftSQL Server для скрытия паролей.

Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_INTEGRATED Если DBPROP_AUTH_INTEGRATED задано значение NULL, строка NULL или значение SSPI VT_BSTR, поставщик OLE DB sql Server Native Client использует режим проверки подлинности Windows для авторизации доступа пользователей к базе данных SQL Server, заданной DBPROP_INIT_DATASOURCE и свойствами DBPROP_INIT_CATALOG.

Если задано значение VT_EMPTY (по умолчанию), используется безопасность SQL Server. Имя входа и пароль SQL Server указаны в свойствах DBPROP_AUTH_USERID и DBPROP_AUTH_PASSWORD.
DBPROP_AUTH_MASK_PASSWORD Поставщик OLE DB собственного клиента SQL Server использует стандартные механизмы безопасности SQL Server для скрытия паролей.

Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PASSWORD Пароль, назначенный имени входа SQL Server. Это свойство используется при выборе проверки подлинности SQL Server для авторизации доступа к базе данных SQL Server.
DBPROP_AUTH_PERSIST_ENCRYPTED Поставщик OLE DB собственного клиента SQL Server не шифрует сведения о проверке подлинности при сохранении.

Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Поставщик OLE DB собственного клиента SQL Server сохраняет значения проверки подлинности, включая образ пароля, если он запрашивается. Шифрование не предоставляется.
DBPROP_AUTH_USERID (имя пользователя для аутентификации) Имя входа SQL Server. Это свойство используется при выборе проверки подлинности SQL Server для авторизации доступа к базе данных SQL Server.
DBPROP_INIT_ASYNCH Поставщик OLE DB собственного клиента SQL Server поддерживает асинхронное инициирование.

Задание бита DBPROPVAL_ASYNCH_INITIALIZE в свойстве DBPROP_INIT_ASYNCH приводит к тому, что IDBInitialize::Initialize станет неблокирующим вызовом. Дополнительные сведения см. в разделе "Выполнение асинхронных операций".
DBPROP_INIT_CATALOG Имя существующей базы данных SQL Server, к которой необходимо подключиться.
DBPROP_INIT_DATASOURCE Сетевое имя сервера под управлением экземпляра MicrosoftSQL Server. Если на компьютере запущено несколько экземпляров SQL Server, для подключения к конкретному экземпляру SQL Server значение DBPROP_INIT_DATASOURCE указывается как \\ServerName\InstanceName. Escape-последовательность \\ используется для обратной косой черты.
DBPROP_INIT_GENERALTIMEOUT Указывает количество секунд до запроса, отличного от инициализации источника данных и выполнения команд, время ожидания. Значение 0 указывает бесконечное время ожидания. Поставщики, работающие над сетевыми подключениями или в распределенных или трансактированных сценариях, могут поддерживать это свойство, чтобы сообщить включенному компоненту время ожидания в случае длительного запроса. Время ожидания для инициализации источника данных и выполнения команд остаются управляемыми DBPROP_INIT_TIMEOUT и DBPROP_COMMANDTIMEOUT соответственно.

DBPROP_INIT_GENERALTIMEOUT доступен только для чтения, и если он пытается задать ошибку dwstatus DBPROPSTATUS_NOTSETTABLE возвращается.
DBPROP_INIT_HWND Дескриптор Windows из вызывающего приложения. Допустимый дескриптор окна необходим для диалогового окна инициализации, отображаемого при запросе свойств инициализации.
DBPROP_INIT_IMPERSONATION_LEVEL Поставщик OLE DB собственного клиента SQL Server не поддерживает настройку уровня олицетворения.

Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_LCID Поставщик OLE DB собственного клиента SQL Server проверяет идентификатор языкового стандарта и возвращает ошибку, если идентификатор языкового стандарта не поддерживается или не установлен на клиенте.
DBPROP_INIT_LOCATION Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_MODE Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
Свойство DBPROP_INIT_PROMPT (запрос при инициализации) Поставщик OLE DB собственного клиента SQL Server поддерживает все режимы запроса для инициализации источника данных. Поставщик OLE DB собственного клиента SQL Server использует DBPROMPT_NOPROMPT в качестве параметра по умолчанию для свойства.
DBPROP_INIT_PROTECTION_LEVEL Поставщик OLE DB собственного клиента SQL Server не поддерживает уровень защиты для подключений к экземплярам SQL Server.

Поставщик OLE DB собственного клиента SQL Server возвращает DB_S_ERRORSOCCURRED при попытке задать значение свойства. Элемент dwStatus структуры DBPROP указывает DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_PROVIDERSTRING См. строку поставщика OLE DB собственного клиента SQL Server далее в этом разделе.
DBPROP_INIT_TIMEOUT Поставщик OLE DB собственного клиента SQL Server возвращает ошибку при инициализации, если подключение к экземпляру SQL Server невозможно установить в течение указанного количества секунд.

В наборе свойств для конкретного поставщика DBPROPSET_SQLSERVERDBINIT поставщик OLE DB sql Server Native Client определяет эти дополнительные свойства инициализации.

Идентификатор объекта недвижимости Описание
SSPROP_AUTH_OLD_PASSWORD Тип: VT_BSTR

R/W: запись

По умолчанию: VT_EMPTY

Описание: текущий или истекший срок действия пароля. Дополнительные сведения см. в статье "Изменение паролей программным способом".
SSPROP_INIT_APPNAME Тип: VT_BSTR

R/W: чтение и запись

Описание: имя клиентского приложения.
SSPROP_INIT_AUTOTRANSLATE Тип: VT_BOOL

R/W: чтение и запись

По умолчанию: VARIANT_TRUE

Описание: преобразование символов OEM/ANSI.

VARIANT_TRUE. Поставщик OLE DB собственного клиента SQL Server преобразует строки символов ANSI, отправленные между клиентом и сервером, преобразовав с помощью Юникода, чтобы свести к минимуму проблемы при сопоставлении расширенных символов между кодовыми страницами на клиенте и сервере:

Клиентские DBTYPE_STR данные, отправленные экземпляруsql Server char, varchar или текстовой переменной, параметру или столбцу, преобразуются из символа в Юникод с помощью клиентской кодовой страницы ANSI (ACP), а затем преобразованы из Юникода в символ с помощью ACP сервера.

Sql Server char, varchar или текстовые данные, отправленные клиенту, DBTYPE_STR переменная преобразуется из символа в Юникод с помощью сервера ACP, а затем преобразуется из Юникода в символ с помощью клиентского ACP.

Эти преобразования выполняются на клиенте поставщиком OLE DB собственного клиента SQL Server. Для этого требуется, чтобы тот же ACP, используемый на сервере, был доступен на клиенте.

Эти параметры не влияют на преобразования, которые происходят для этих передач:

Юникод DBTYPE_WSTR клиентские данные, отправленные в char, varchar или текст на сервере.

данные char, varchar или текстового сервера, отправленные в переменную Юникода DBTYPE_WSTR на клиенте.

ANSI DBTYPE_STR клиентские данные, отправленные в Юникод nchar, nvarchar или ntext на сервере.

Данные юникода char, varchar или текстового сервера, отправленные в переменную ANSI DBTYPE_STR на клиенте.

VARIANT_FALSE. Поставщик OLE DB собственного клиента SQL Server не выполняет перевод символов.

Поставщик OLE DB собственного клиента SQL Server не преобразует символы ANSI клиента DBTYPE_STR данные, отправленные в char, varchar или текстовые переменные, параметры или столбцы на сервере. Преобразование не выполняется на char, varchar или текстовых данных, отправляемых с сервера на DBTYPE_STR переменных клиента.

Если клиент и экземпляр SQL Server используют разные APS, расширенные символы могут быть неправильно интерпретированы.
SSPROP_INIT_CURRENTLANGUAGE Тип: VT_BSTR

R/W: чтение и запись

Описание: имя языка SQL Server. Определяет язык, используемый для выбора системного сообщения и форматирования. Язык должен быть установлен на компьютере под управлением экземпляра SQL Server или инициализации источника данных.
SSPROP_INIT_DATATYPECOMPATIBILITY Тип: VT_UI2

R/W: чтение и запись

По умолчанию: 0

Описание. Включает совместимость типов данных между приложениями SQL Server и ActiveX Data Object (ADO). Если используется значение по умолчанию 0, тип данных обрабатывает значения по умолчанию, используемые поставщиком. Если используется значение 80, обработка типов данных использует только типы данных SQL Server 2000. Дополнительные сведения см. в статье Об использовании ADO с собственным клиентом SQL Server.
SSPROP_INIT_ENCRYPT Тип: VT_BOOL

R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Чтобы зашифровать данные, передаваемые по сети, для свойства SSPROP_INIT_ENCRYPT задано значение VARIANT_TRUE.

Если включено шифрование протокола, шифрование всегда будет происходить независимо от параметра SSPROP_INIT_ENCRYPT. Если он отключен и SSPROP_INIT_ENCRYPT задано значение VARIANT_TRUE, то будет происходить шифрование.

Если включение шифрования протоколов отключено и SSPROP_INIT_ENCRYPT задано значение VARIANT_FALSE, шифрование не выполняется.
SSPROP_INIT_FAILOVERPARTNER Тип: VT_BSTR

R/W: чтение и запись

Описание. Указывает имя партнера отработки отказа для зеркального отображения базы данных. Это свойство инициализации и может быть задано только перед инициализацией. После инициализации он вернет партнера отработки отказа, если таковой есть, возвращенный первичным сервером.

Это позволяет интеллектуальному приложению кэшировать последний определенный сервер резервного копирования, но такие приложения должны учитывать, что информация обновляется только при первом установке подключения (или сбросе, если пул) и может стать устаревшим для долгосрочных подключений.

После подключения приложение может запросить этот атрибут, чтобы определить удостоверение партнера отработки отказа. Если у основного сервера нет партнера по отработке отказа, это свойство вернет пустую строку. Дополнительные сведения см. в разделе "Использование зеркального отображения базы данных".
SSPROP_INIT_FILENAME Тип: VT_BSTR

R/W: чтение и запись

Описание. Указывает имя основного файла в присоединенной базе данных. Эта база данных присоединена и становится базой данных по умолчанию для подключения. Чтобы использовать SSPROP_INIT_FILENAME, необходимо указать имя базы данных в качестве значения свойства инициализации DBPROP_INIT_CATALOG. Если имя базы данных не существует, он ищет имя первичного файла, указанное в SSPROP_INIT_FILENAME, и присоединяет ее с именем, указанным в DBPROP_INIT_CATALOG. Если база данных была подключена ранее, SQL Server не повторно прикрепить ее.
SSPROP_INIT_MARSCONNECTION Тип: VT_BOOL

R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Указывает, включены ли несколько активных результирующих наборов (MARS) для подключения. Этот параметр должен иметь значение true перед подключением к базе данных. Дополнительные сведения см. в разделе Использование множественных активных результирующих наборов (MARS).
SSPROP_INIT_NETWORKADDRESS Тип: VT_BSTR

R/W: чтение и запись

Описание. Сетевой адрес сервера, на котором выполняется экземпляр SQL Server, указанный свойством DBPROP_INIT_DATASOURCE.
SSPROP_INIT_NETWORKLIBRARY Тип: VT_BSTR

R/W: чтение и запись

Описание. Имя сетевогоlibrary (DLL), используемое для взаимодействия с экземпляром SQL Server. Имя не должно включать путь или расширение имени файла .dll.

По умолчанию можно настроить с помощью служебной программы конфигурации клиента SQL Server. Заметка: Это свойство поддерживает только TCP и именованные каналы. Если это свойство используется с префиксом, в конечном итоге используется двойный префикс, который приводит к ошибке, так как свойство используется для создания префикса внутри.
SSPROP_INIT_PACKETSIZE Тип: VT_I4

R/W: чтение и запись

Описание: размер сетевого пакета в байтах. Значение свойства размера пакета должно быть от 512 до 32 767. Размер сетевого пакета поставщика OLE DB поставщика OLE DB для SQL Server по умолчанию — 4096.
SSPROP_INIT_TAGCOLUMNCOLLATION Тип: BOOL

R/W: запись

По умолчанию: FALSE

Описание. Используется во время обновления базы данных при использовании серверных курсоров. Это свойство тегов данных с данными о сортировке, полученными от сервера, а не кодовой странице на клиенте. В настоящее время это свойство используется только распределенным процессом запроса, так как он знает параметры сортировки целевых данных и правильно преобразует его.
SSPROP_INIT_TRUST_SERVER_CERTIFICATE Тип: VT_BOOL

R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Используется для включения или отключения проверки сертификата сервера. Это свойство является чтением и записью, но попытка задать его после установки подключения приведет к ошибке.

Это свойство игнорируется, если клиент настроен на требование проверки сертификата. Однако приложение может использовать его вместе с SSPROP_INIT_ENCRYPT, чтобы гарантировать, что его подключение к серверу зашифровано, даже если клиент настроен не требует шифрования, и сертификат не подготовлен на клиенте.

Клиентские приложения могут запрашивать это свойство после открытия подключения, чтобы определить фактические параметры шифрования и проверки, используемые. Заметка: Использование шифрования без проверки сертификата обеспечивает частичную защиту от сниффинга пакетов, но она не защищает от атак злоумышленника в середине. Он просто позволяет шифровать имя входа и данные, отправленные на сервер, не проверяя сертификат сервера.

Дополнительные сведения см. в разделе "Использование шифрования без проверки".
SSPROP_INIT_USEPROCFORPREP Тип: VT_I4

R/W: чтение и запись

По умолчанию: SSPROPVAL_USEPROCFORPREP_ON

Описание: используется хранимая процедура SQL Server. Определяет использование временных хранимых процедур SQL Server для поддержки интерфейса ICommandPrepare . Это свойство было значимым только при подключении к SQL Server 6.5. Свойство игнорируется для более поздних версий.

SSPROPVAL_USEPROCFORPREP_OFF. Временная хранимая процедура не создается при подготовке команды.

SSPROPVAL_USEPROCFORPREP_ON. При подготовке команды создается временная хранимая процедура. Временные хранимые процедуры удаляются при выпуске сеанса.

SSPROPVAL_USEPROCFORPREP_ON_DROP. При подготовке команды создается временная хранимая процедура. Процедура удаляется при неподготовленной команде с помощью ICommandPrepare::Unprepare, когда новая команда указана для объекта команды с ICommandText::SetCommandText или при освобождении всех ссылок на приложение на команду.
SSPROP_INIT_WSID Тип: VT_BSTR

R/W: чтение и запись

Описание: строка, определяющая рабочую станцию.

В наборе свойств для конкретного поставщика DBPROPSET_SQLSERVERDATASOURCEINFO поставщик OLE DB sql Server Native Client определяет дополнительные свойства; Дополнительные сведения см. в разделе "Свойства источника данных ".

Строка поставщика OLE DB для собственного клиента SQL Server

Поставщик OLE DB собственного клиента SQL Server распознает синтаксис ODBC, похожий на ODBC, в значениях строк поставщика. Свойство строки поставщика предоставляется в качестве значения свойства инициализации OLE DB DBPROP_INIT_PROVIDERSTRING при установке подключения к источнику данных OLE DB. Это свойство указывает данные подключения, относящиеся к поставщику OLE DB, необходимые для реализации подключения к источнику данных OLE DB. В строке элементы разделяются точкой с запятой. Конечный элемент строки должен быть завершен точкой с запятой. Каждый элемент состоит из ключевого слова, символа равного знака и значения, переданного при инициализации. Рассмотрим пример.

Server=MyServer;UID=MyUserName;  

При использовании поставщика OLE DB собственного клиента SQL Server потребитель никогда не должен использовать свойство строки поставщика. Потребитель может задать любое свойство инициализации, отраженное в строке поставщика, с помощью свойств инициализации OLE DB для собственного клиента OLE DB или OLE Server.

Список ключевых слов, доступных в поставщике OLE DB собственного клиента SQL Server, см. в разделе "Использование ключевых слов строки подключения" с собственным клиентом SQL Server.

См. также

Объекты источника данных (OLE DB)