SQLRemoveDriverManager 함수

규칙
도입된 버전: ODBC 3.0: Windows XP 서비스 팩 2, Windows Server 2003 서비스 팩 1 이상 운영 체제에서 사용되지 않습니다.

요약
SQLRemoveDriverManager 는 시스템 정보의 Odbcinst.ini 항목에서 ODBC 핵심 구성 요소에 대한 정보를 변경하거나 제거합니다.

구문

  
BOOL SQLRemoveDriverManager(  
     LPDWORD     pdwUsageCount);  

인수

pdwUsageCount
[출력] 이 함수가 호출된 후 드라이버 관리자의 사용 횟수입니다.

반품

이 함수는 성공하면 TRUE를 반환하고 실패하면 FALSE를 반환합니다. 이 함수를 호출할 때 시스템 정보에 항목이 없으면 함수는 FALSE를 반환합니다.

진단

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

*pfErrorCode	Error	설명
ODBC_ERROR_GENERAL_ERR	일반 설치 관리자 오류	특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_COMPONENT_NOT_FOUND	레지스트리에서 구성 요소를 찾을 수 없음	레지스트리에 없거나 레지스트리에서 찾을 수 없으므로 설치 관리자에서 드라이버 관리자 정보를 제거할 수 없습니다.
ODBC_ERROR_USAGE_UPDATE_FAILED	구성 요소 사용 횟수를 증가 또는 감소시킬 수 없습니다.	설치 관리자가 드라이버 관리자의 사용 횟수를 줄이지 못했습니다.
ODBC_ERROR_OUT_OF_MEM	메모리 부족	메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

SQLRemoveDriverManager 는 SQLInstallDriverManager 함수를 보완하고 시스템 정보의 구성 요소 사용 횟수를 업데이트합니다. 이 함수는 설치 애플리케이션에서만 호출해야 합니다.

SQLRemoveDriverManager 는 핵심 구성 요소 사용 횟수를 1로 줄입니다. 구성 요소 사용 횟수가 0으로 이동하면 항목 시스템 정보가 제거됩니다. 핵심 구성 요소 항목은 "ODBC Core"라는 제목 아래 시스템 정보의 다음 위치에 있습니다.

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

주의

구성 요소 사용 횟수 및 파일 사용 횟수가 0에 도달하면 애플리케이션이 드라이버 관리자 파일을 물리적으로 제거해서는 안 됩니다.

SQLRemoveDriverManager 는 실제로 파일을 제거하지 않습니다. 호출 프로그램은 파일을 삭제하고 파일 사용 횟수를 유지 관리합니다. 그러나 구성 요소 사용 횟수와 파일 사용 횟수가 모두 0에 도달한 경우 드라이버 관리자 파일을 제거해서는 안 됩니다. 이러한 파일은 파일 사용 횟수를 증가시키지 않은 다른 애플리케이션에서 사용할 수 있기 때문입니다.

SQLRemoveDriverManager 는 제거 프로세스의 일부로 호출됩니다. ODBC 핵심 구성 요소(드라이버 관리자, 커서 라이브러리, 설치 관리자, 언어 라이브러리, 관리자, unking 파일 등 포함)는 전체적으로 제거됩니다. SQLRemoveDriverManager가 제거 프로세스의 일부로 호출될 때 다음 파일이 제거되지 않습니다.

ODBC32DLL
ODBCCR32.DLL
ODBCCU32.DLL
ODBCINT.DLL
ODBCTRAC.DLL
MSVCRT40.DLL
ODBCCP32.CPL

ODBCCP32.DLL
ODBC16GT.DLL
ODBC32GT.DLL
DS16GT.DLL
DS32GT.DLL
ODBCAD32.EXE

SQLRemoveDriverManager 도 업그레이드 프로세스의 일부로 호출됩니다. 애플리케이션이 업그레이드를 수행해야 한다는 것을 감지하고 이전에 드라이버를 설치한 경우 드라이버를 제거한 다음 다시 설치해야 합니다.

먼저 구성 요소 사용 횟수를 감소하기 위해 SQLRemoveDriverManager 를 호출해야 합니다. 그런 다음 SQLInstallDriverEx 를 호출하여 구성 요소 사용 횟수를 증가시켜야 합니다. 애플리케이션 설치 프로그램은 이전 핵심 구성 요소 파일을 새 파일로 바꿔야 합니다. 파일 사용 횟수는 동일하게 유지되며 이전 버전 코어 구성 요소 파일을 사용하는 다른 애플리케이션은 이제 최신 버전 파일을 사용합니다.

관련 함수

추가 정보	참조
드라이버 관리자 설치	SQLInstallDriverManager