다음을 통해 공유

SQLWriteDSNToIni 함수

  • 아티클

규칙
버전 소개: ODBC 1.0

요약
SQLWriteDSNToIni 는 시스템 정보에 데이터 원본을 추가합니다.

구문

  
BOOL SQLWriteDSNToIni(  
     LPCSTR   lpszDSN,  
     LPCSTR   lpszDriver);

인수

lpszDSN
[입력] 추가할 데이터 원본의 이름입니다.

lpszDriver
[입력] 실제 드라이버 이름 대신 사용자에게 표시되는 드라이버 설명(일반적으로 연결된 DBMS의 이름)입니다.

반품

이 함수는 성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다.

진단

SQLWriteDSNToIni가 FALSE를 반환하면 SQLInstallerError를 호출하여 연결된 *pfErrorCode 값을 가져올 수 있습니다. 다음 표에서는 SQLInstallerError에서 반환할 수 있는 *pfErrorCode 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다.

*pfErrorCode Error 설명
ODBC_ERROR_GENERAL_ERR 일반 설치 관리자 오류 특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_INVALID_DSN 잘못된 DSN lpszDSN 인수에는 DSN에 유효하지 않은 문자열이 포함되어 있습니다.
ODBC_ERROR_INVALID_NAME 드라이버 또는 번역기 이름이 잘못되었습니다. lpszDriver 인수가 잘못되었습니다.
ODBC_ERROR_REQUEST_FAILED 요청 실패 설치 관리자가 레지스트리에서 DSN을 만들지 못했습니다.
ODBC_ERROR_OUT_OF_MEM 메모리 부족 메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

SQLWriteDSNToIni 는 시스템 정보의 [ODBC 데이터 원본] 섹션에 데이터 원본을 추가합니다. 그런 다음 데이터 원본에 대한 사양 섹션을 만들고 드라이버 DLL의 이름을 값으로 사용하여 단일 키워드(드라이버)를 추가합니다. 데이터 원본 사양 섹션이 이미 있는 경우 SQLWriteDSNToIni 는 새 섹션을 만들기 전에 이전 섹션을 제거합니다.

이 함수의 호출자는 시스템 정보의 데이터 원본 사양 섹션에 드라이버별 키워드 및 값을 추가해야 합니다.

데이터 원본의 이름이 Default 이면 SQLWriteDSNToIni 도 시스템 정보에 기본 드라이버 사양 섹션을 만듭니다.

이 함수는 설치 DLL에서만 호출해야 합니다.

추가 정보 참조
데이터 원본 추가, 수정 또는 제거 ConfigDSN(설치 DLL에서)
데이터 원본 추가, 수정 또는 제거 SQLConfigDataSource
시스템 정보에서 데이터 원본 이름 제거 SQLRemoveDSNFromIni