Функция SQLWriteDSNToIniSQLWriteDSNToIni Function

СоответствияConformance
Введенная версия: ODBC 1,0Version Introduced: ODBC 1.0

СводкаSummary
Склвритедснтоини добавляет источник данных к системным сведениям.SQLWriteDSNToIni adds a data source to the system information.

СинтаксисSyntax

  
BOOL SQLWriteDSNToIni(  
     LPCSTR   lpszDSN,  
     LPCSTR   lpszDriver);  

АргументыArguments

лпсздснlpszDSN
Входной Имя добавляемого источника данных.[Input] Name of the data source to add.

лпсздриверlpszDriver
Входной Описание драйвера (обычно имя связанной СУБД), представленное пользователям вместо физического имени драйвера.[Input] Driver description (usually the name of the associated DBMS) presented to users instead of the physical driver name.

Возвращаемое значениеReturns

Функция возвращает TRUE, если она успешна, и FALSE в случае сбоя.The function returns TRUE if it is successful, FALSE if it fails.

ДиагностикаDiagnostics

Когда склвритедснтоини возвращает значение false, связанное значение * * пферроркоде* может быть получено путем вызова склинсталлереррор.When SQLWriteDSNToIni returns FALSE, an associated *pfErrorCode value can be obtained by calling SQLInstallerError. В следующей таблице перечислены значения * * пферроркоде* , которые могут быть возвращены склинсталлереррор , и объясняется каждый из них в контексте этой функции.The following table lists the *pfErrorCode values that can be returned by SQLInstallerError and explains each one in the context of this function.

*пферроркоде*pfErrorCode ОшибкаError ОписаниеDescription
ODBC_ERROR_GENERAL_ERRODBC_ERROR_GENERAL_ERR Общая ошибка установщикаGeneral installer error Произошла ошибка, для которой не возникала конкретная ошибка установщика.An error occurred for which there was no specific installer error.
ODBC_ERROR_INVALID_DSNODBC_ERROR_INVALID_DSN Недопустимое имя DSNInvalid DSN Аргумент лпсздсн содержал строку, недопустимую для имени DSN.The lpszDSN argument contained a string that was invalid for a DSN.
ODBC_ERROR_INVALID_NAMEODBC_ERROR_INVALID_NAME Недопустимое имя драйвера или транслятораInvalid driver or translator name Недопустимый аргумент лпсздривер .The lpszDriver argument was invalid.
ODBC_ERROR_REQUEST_FAILEDODBC_ERROR_REQUEST_FAILED Не удалось выполнить запросRequest failed Установщику не удалось создать имя DSN в реестре.The installer failed to create a DSN in the registry.
ODBC_ERROR_OUT_OF_MEMODBC_ERROR_OUT_OF_MEM Недостаточно памятиOut of memory Установщику не удалось выполнить функцию из-за нехватки памяти.The installer could not perform the function because of a lack of memory.

КомментарииComments

Склвритедснтоини добавляет источник данных в раздел [источники данных ODBC] сведений о системе.SQLWriteDSNToIni adds the data source to the [ODBC Data Sources] section of the system information. Затем он создает раздел спецификации для источника данных и добавляет одно ключевое слово (Driver) с именем библиотеки DLL драйвера в качестве значения.It then creates a specification section for the data source and adds a single keyword (Driver) with the name of the driver DLL as its value. Если раздел спецификации источника данных уже существует, склвритедснтоини удаляет старый раздел перед созданием нового.If the data source specification section already exists, SQLWriteDSNToIni removes the old section before creating the new one.

Вызывающая эта функция должна добавить любые ключевые слова и значения, относящиеся к драйверу, в раздел спецификации источника данных сведений о системе.The caller of this function must add any driver-specific keywords and values to the data source specification section of the system information.

Если имя источника данных — Default, склвритедснтоини также создает раздел спецификации драйвера по умолчанию в сведениях о системе.If the name of the data source is Default, SQLWriteDSNToIni also creates the default driver specification section in the system information.

Эта функция должна вызываться только из библиотеки DLL установки.This function should be called only from a setup DLL.

Сведения оFor information about См.See
Добавление, изменение или удаление источника данныхAdding, modifying, or removing a data source ConfigDSN(в библиотеке DLL установки)ConfigDSN(in the Setup DLL)
Добавление, изменение или удаление источника данныхAdding, modifying, or removing a data source SQLConfigDataSourceSQLConfigDataSource
Удаление имени источника данных из сведений о системеRemoving a data source name from the system information склремоведснфроминиSQLRemoveDSNFromIni