SQLRemoveTranslator 함수

규칙
버전 소개: ODBC 3.0

요약
SQLRemoveTranslator 는 시스템 정보의 Odbcinst.ini 섹션에서 번역기에 대한 정보를 제거하고 번역기의 구성 요소 사용 횟수를 1로 줄입니다.

구문

  
BOOL SQLRemoveTranslator(  
     LPCSTR    lpszTranslator,  
     LPDWORD   lpdwUsageCount);  

인수

lpszTranslator
[입력] 시스템 정보의 Odbcinst.ini 키에 등록된 번역기의 이름입니다.

lpdwUsageCount
[출력] 이 함수가 호출된 후 변환기의 사용 횟수입니다.

반품

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

진단

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

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

주석

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

SQLRemoveTranslator 는 구성 요소 사용 횟수를 1로 줄입니다. 구성 요소 사용 횟수가 0으로 이동하면 시스템 정보의 번역기 항목이 제거됩니다. 번역기 항목은 번역기 이름 아래 시스템 정보의 다음 위치에 있습니다.

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

SQLRemoveTranslator 는 실제로 파일을 제거하지 않습니다. 호출 프로그램은 파일을 삭제하고 파일 사용 횟수를 유지 관리합니다. 구성 요소 사용 횟수와 파일 사용 횟수가 모두 0에 도달한 후에만 파일이 물리적으로 삭제됩니다. 구성 요소의 일부 파일은 삭제할 수 있으며 다른 파일은 파일 사용 횟수가 증가한 다른 애플리케이션에서 사용되는지 여부에 따라 삭제되지 않습니다.

SQLRemoveTranslator 는 업그레이드 프로세스의 일부로도 호출됩니다. 애플리케이션이 업그레이드를 수행해야 한다는 것을 감지하고 이전에 드라이버를 설치한 경우 드라이버를 제거한 다음 다시 설치해야 합니다. 먼저 구성 요소 사용 횟수를 감소하기 위해 SQLRemoveTranslator 를 호출한 다음 , 구성 요소 사용 횟수를 증가하기 위해 SQLInstallTranslatorEx 를 호출해야 합니다. 애플리케이션 설치 프로그램은 이전 파일을 새 파일로 물리적으로 바꿔야 합니다. 파일 사용 횟수는 동일하게 유지되며 이전 버전 파일을 사용하는 다른 애플리케이션은 이제 최신 버전을 사용합니다.

관련 함수

추가 정보	참조
번역기 설치	SQLInstallTranslatorEx