Свойства инициализации и авторизации
Поставщик OLE DB для собственного клиента SQL Server интерпретирует свойства инициализации и авторизации OLE DB следующим образом.
Cвойство |
Description |
|---|---|
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, пустая строка или значение 'SSPI' VT_BSTR, поставщик OLE DB для собственного клиента SQL Server использует для авторизации доступа пользователя к базе данных SQL Server, указанной в свойствах DBPROP_INIT_DATASOURCE и DBPROP_INIT_CATALOG, механизм проверки подлинности Windows. Если задано значение 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 указывается в виде \\Имя_сервера\имя_экземпляра. Escape-последовательность \\ используется в качестве косой черты. |
DBPROP_INIT_GENERALTIMEOUT |
Указывает количество секунд перед истечением времени запроса, отличного от инициализации источника данных и выполнения команды. Значение 0 указывает на бесконечное время ожидания. Поставщики, работающие через сетевые соединения, в распределенных сценариях или сценариях транзакций, могут поддерживать это свойство, чтобы принудительно сократить время ожидания задействованного компонента в случае долгого выполнения запроса. Сроки ожидания для инициализации источников данных или выполнения команд продолжают управляться соответственно свойствами DBPROP_INIT_TIMEOUT и DBPROP_COMMANDTIMEOUT. Свойство DBPROP_INIT_GENERALTIMEOUT доступно только для чтения, и при попытке его задать возвращается ошибка dwstatus DBPROPSTATUS_NOTSETTABLE. |
DBPROP_INIT_HWND |
Дескриптор окна из вызывающего приложения. Допустимый дескриптор окна требуется для инициализации диалогового окна, которое отображается, если разрешен запрос свойств инициализации. |
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 определяет эти дополнительные свойства инициализации.
Cвойство |
Description |
|---|---|
SSPROP_AUTH_OLD_PASSWORD |
Тип: VT_BSTR. Чтение-запись: Запись По умолчанию: VT_EMPTY Описание: Текущий или истекший пароль. Дополнительные сведения см. в разделе Смена пароля программным способом. |
SSPROP_INIT_APPNAME |
Тип: VT_BSTR. Чтение-запись: Чтение и запись Описание: Имя клиентского приложения. |
SSPROP_INIT_AUTOTRANSLATE |
Тип: VT_BOOL. Чтение-запись: Чтение и запись По умолчанию: VARIANT_TRUE Описание: Преобразование символов OEM/ANSI. VARIANT_TRUE: Поставщик OLE DB для собственного клиента SQL Server преобразует символьные строки ANSI, отправляемые с клиента на сервер и обратно, через Юникод, чтобы свести к минимуму количество проблем при сопоставлении расширенных символов в кодовых страницах на клиенте и сервере: Данные DBTYPE_STR, отправляемые в переменную, параметр или столбец на экземпляре SQL Server типа char, varchar или text, преобразуются из символов в Юникод с помощью кодовой страницы ANSI (ACP) клиента, а затем преобразуются из Юникода в символы с помощью ACP сервера. SQL Server Данные char, varchar или text, отправляемые в переменную DBTYPE_STR на клиенте, преобразуются из символов в Юникод с помощью ACP сервера, а затем преобразуются из Юникода в символы с помощью ACP клиента. Преобразования выполняются на клиенте поставщиком OLE DB для собственного клиента SQL Server. Для этого необходимо, чтобы на клиенте была доступна такая же ACP, какая используется на сервере. Следующие параметры не влияют на преобразования, выполняемые для этих передач. Данные переменной DBTYPE_WSTR в Юникоде, отправляемые с клиента на сервер в тип char, varchar или text. Данные типов char, varchar или text с сервера, отправляемые в переменную DBTYPE_WSTR на клиент. Данные переменной DBTYPE_WSTR в кодировке ANSI, отправляемые с клиента на сервер в Юникод в тип nchar, nvarchar или text. Данные Юникод типов char, varchar или text с сервера, отправляемые в переменную DBTYPE_WSTR на клиент в кодировку ANSI. VARIANT_FALSE: Поставщик OLE DB для собственного клиента SQL Server не выполняет преобразование символов. Поставщик OLE DB для собственного клиента SQL Server не преобразует данные клиента из переменной DBTYPE_STR в кодировке ANSI, отправляемые в переменные, параметры или столбцы типов char, varchar или text на сервере. Не выполняется преобразование данных типов char, varchar или text, отправляемых с сервера в переменные DBTYPE_STR на клиенте. Если на клиенте и экземпляре SQL Server используются разные ACP, расширенные символы могут быть преобразованы неправильно. |
SSPROP_INIT_CURRENTLANGUAGE |
Тип: VT_BSTR. Чтение-запись: Чтение и запись Описание: Название языка SQL Server. Указывает язык, используемый для выбора и форматирования системных сообщений. Язык должен быть установлен на компьютере, на котором запущен экземпляр SQL Server, в противном случае инициализация источника данных не будет выполнена. |
SSPROP_INIT_DATATYPECOMPATIBILITY |
Тип: VT_UI2 Чтение-запись: Чтение и запись По умолчанию: 0 Описание: Обеспечивает совместимость типов данных между SQL Server и приложениями ActiveX Data Object (ADO). Если используется значение 0 (по умолчанию), используется такая же обработка типов данных, какая применяется поставщиком. Если установлено значение 80, для обработки типов данных используются только типы данных SQL Server 2000. Дополнительные сведения см. в разделе Использование ADO с собственным клиентом SQL Server. |
SSPROP_INIT_ENCRYPT |
Тип: VT_BOOL. Чтение-запись: Чтение/Запись По умолчанию: 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. Чтение-запись: Чтение и запись Описание: Указывает имя участника, являющегося резервным сервером для зеркального отображения баз данных. Это свойство инициализации, его можно задать только перед инициализацией. После инициализации оно будет возвращать имя отказоустойчивого участника (если он есть), возвращаемое сервером-источником. Это позволяет смарт-приложениям кэшировать последний назначенный сервер резервного копирования, но таким приложениям должно быть известно, что данные обновляются только при первой установке соединения (или при возобновлении, при наличии пула) и могут устареть в случае длительных соединений. После установки соединения приложение может запрашивать этот атрибут, чтобы идентифицировать резервный участник. Если сервер-источник не имеет резервного участника, то это свойство вернет пустую строку. Дополнительные сведения см. в разделе Использование зеркального отображения базы данных. |
SSPROP_INIT_FILENAME |
Тип: VT_BSTR. Чтение-запись: Чтение и запись Описание: Указывает имя первичного файла присоединяемой базы данных. Эта база данных присоединяется и становится для соединения базой данных по умолчанию. Чтобы использовать свойство SSPROP_INIT_FILENAME, необходимо указать имя базы данных в качестве значения свойства инициализации DBPROP_INIT_CATALOG. Если имя базы данных не существует, выполняется поиск имени первичного файла, указанного в свойстве SSPROP_INIT_FILENAME, и присоединяется база данных с именем, указанным в свойстве DBPROP_INIT_CATALOG. Если база данных была ранее присоединена, SQL Server не присоединяет ее снова. Этот параметр допустим только при подключении к SQL Server 2000 или более поздней версии. |
SSPROP_INIT_MARSCONNECTION |
Тип: VT_BOOL. Чтение-запись: Чтение и запись По умолчанию: VARIANT_FALSE Описание: Указывает, включены ли для соединения множественные активные результирующие наборы (MARS). Если выполняется подключение к базе данных, для этого параметра должно быть предварительно установлено значение true. Дополнительные сведения см. в разделе Использование режима MARS. |
SSPROP_INIT_NETWORKADDRESS |
Тип: VT_BSTR. Чтение-запись: Чтение и запись Описание: Сетевой адрес сервера, на котором запущен экземпляр SQL Server, указанный в свойстве DBPROP_INIT_DATASOURCE. |
SSPROP_INIT_NETWORKLIBRARY |
Тип: VT_BSTR. Чтение-запись: Чтение и запись Описание: Имя сетевой библиотеки (DLL), используемой для связи с экземпляром SQL Server. Имя не должно включать путь или расширение имени файла DLL. Значение по умолчанию можно настроить с помощью средства настройки клиента SQL Server. .gif "Примечание") Примечание
Это свойство поддерживает только TCP и именованные каналы. Если это свойство используется с префиксом, в конечном итоге появятся два префикса, что приведет к ошибке, поскольку это свойство создает префиксы внутри себя.
|
SSPROP_INIT_PACKETSIZE |
Тип: VT_I4. Чтение-запись: Чтение и запись Описание: Размер сетевого пакета в байтах. Значение свойства, определяющего размер сетевого пакета, должно быть от 512 и 32 767. По умолчанию для поставщика OLE DB для собственного клиента SQL Server размер сетевого пакета составляет 4 096. |
SSPROP_INIT_TAGCOLUMNCOLLATION |
Тип: BOOL Чтение-запись: Запись По умолчанию: FALSE Описание: Используется во время обновления базы данных, если используются курсоры на стороне сервера. Это свойство добавляет к данным тег со сведениями о порядке сортировки, полученными с сервера, вместо кодовой страницы на клиенте. В настоящее время это свойство используется только процессом распределенных запросов, поскольку он знает порядок сортировки данных назначения и преобразует его правильно. |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
Тип: VT_BOOL. Чтение-запись: Чтение и запись По умолчанию: VARIANT_FALSE Описание: Используется для включения и отключения проверки сертификата сервера. Это свойство доступно для чтения и записи, но попытка задать его после установки соединения приводит к ошибке. Это свойство игнорируется, если на клиенте настроен запрос проверки сертификата. Однако приложение может использовать его вместе со свойством SSPROP_INIT_ENCRYPT, чтобы гарантировать шифрование подключения к серверу, даже если на клиенте не настроен запрос проверки сертификата и сертификат на клиенте не задан. Клиентские приложения могут запрашивать это свойство после открытия соединения для получения используемых параметров шифрования и проверки. Примечание
Использование шифрования без проверки сертификата обеспечивает частичную защиту от разбора пакетов, но оно не защищает от атак «злоумышленник в середине». Оно просто позволяет шифровать имя входа и данные, передаваемые на сервер, без проверки сертификата сервера.
Дополнительные сведения см. в разделе Использование шифрования без проверки. |
SSPROP_INIT_USEPROCFORPREP |
Тип: VT_I4. Чтение-запись: Чтение и запись По умолчанию: 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, или при освобождении всех ссылок приложения на команду. Примечание
Поставщик OLE DB для собственного клиента SQL Server не поддерживает подключение к SQL Server 6.5 и более ранним версиям.
|
SSPROP_INIT_WSID |
Тип: VT_BSTR. Чтение-запись: Чтение и запись Описание: Строка, указывающая рабочую станцию. |
В специфическом для поставщика наборе свойств DBPROPSET_SQLSERVERDATASOURCEINFO поставщик OLE DB для собственного клиента SQL Server определяет эти дополнительные свойства. Дополнительные сведения см. в разделе Свойства сведений об источнике данных.
Строка поставщика OLE DB для собственного клиента SQL Server
Поставщик OLE DB для собственного клиента SQL Server распознает синтаксис ODBC в значениях свойств строки поставщика. Свойство строки поставщика задается как значение свойства инициализации OLE DB, DBPROP_INIT_PROVIDERSTRING, при установке соединения с источником данных OLE DB. Это свойство сообщает данные для подключения, специфические для поставщика OLE DB и необходимые для установки соединения с источником данных OLE DB. В этой строке элементы разделяются точкой с запятой. После последнего элемента в строке также должна стоять точка с запятой. Каждый элемент состоит из ключевого слова, знака «равно» и значения, передаваемого при инициализации. Например,
Server=MyServer;UID=MyUserName;
Потребитель не должен использовать свойство строки поставщика с поставщиком OLE DB для собственного клиента SQL Server. Потребитель может задать любое свойство инициализации, отраженное в строке поставщика, с помощью свойств инициализации, специфических для поставщика OLE DB или поставщика OLE DB для собственного клиента SQL Server.
Список ключевых слов, доступных в поставщике OLE DB для собственного клиента SQL Server, см. в разделе Использование ключевых слов строки соединения с собственным клиентом SQL Server.