SQLGetTranslator 함수

규칙
버전 소개: ODBC 2.0

요약
SQLGetTranslator 는 사용자가 번역기를 선택할 수 있는 대화 상자를 표시합니다.

구문

  
BOOL SQLGetTranslator(  
     HWND      hwndParent,  
     LPSTR     lpszName,  
     WORD      cbNameMax,  
     WORD *    pcbNameOut,  
     LPSTR     lpszPath,  
     WORD      cbPathMax,  
     WORD *    pcbPathOut,  
     DWORD *   pvOption);  

인수

hwndParent
[입력] 부모 창 핸들입니다.

lpszName
[입/출력] 시스템 정보의 번역기 이름입니다.

cbNameMax
[입력] lpszName 버퍼의 최대 길이입니다.

pcbNameOut
[입/출력] lpszName에서 전달되거나 반환된 총 바이트 수(null 종료 바이트 제외)입니다. 반환할 수 있는 바이트 수가 cbNameMax보다 크거나 같으면 lpszName의 번역기 이름이 cbNameMax에서 null 종료 문자를 뺀 값으로 잘립니다. pcbNameOut 인수는 null 포인터일 수 있습니다.

lpszPath
[출력] 번역 DLL의 전체 경로입니다.

cbPathMax
[입력] lpszPath 버퍼의 최대 길이입니다 .

pcbPathOut
[출력] lpszPath에서 반환된 총 바이트 수(null 종료 바이트 제외)입니다. 반환할 수 있는 바이트 수가 cbPathMax보다 크거나 같으면 lpszPath의 변환 DLL 경로가 cbPathMax에서 null 종료 문자를 뺀 값으로 잘립니다. pcbPathOut 인수는 null 포인터일 수 있습니다.

pvOption
[출력] 32비트 변환 옵션입니다.

반품

이 함수는 성공하면 TRUE를 반환하고, 실패하거나 사용자가 대화 상자를 취소하면 FALSE를 반환합니다.

진단

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

*pfErrorCode	Error	설명
ODBC_ERROR_GENERAL_ERR	일반 설치 관리자 오류	특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_INVALID_BUFF_LEN	버퍼 길이가 잘못되었습니다.	cbNameMax 또는 cbPathMax 인수가 0보다 작거나 같습니다.
ODBC_ERROR_INVALID_HWND	잘못된 창 핸들	hwndParent 인수가 잘못되었거나 NULL입니다.
ODBC_ERROR_INVALID_NAME	드라이버 또는 번역기 이름이 잘못되었습니다.	lpszName 인수가 잘못되었습니다. 레지스트리에서 찾을 수 없습니다.
ODBC_ERROR_LOAD_LIBRARY_FAILED	드라이버 또는 번역기 설치 라이브러리를 로드할 수 없음	번역기 라이브러리를 로드할 수 없습니다.
ODBC_ERROR_INVALID_OPTION	잘못된 트랜잭션 옵션	pvOption 인수에 잘못된 값이 포함되어 있습니다.
ODBC_ERROR_OUT_OF_MEM	메모리 부족	메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

hwndParent가 null이거나 lpszName, lpszPath 또는 pvOption이 null 포인터인 경우 SQLGetTranslator는 FALSE를 반환합니다. 그렇지 않으면 다음 대화 상자에 설치된 번역기 목록이 표시됩니다.

lpszName에 유효한 번역기 이름이 포함되어 있으면 해당 이름이 선택됩니다. 그렇지 않으면 <Translator> 가 선택되지 않습니다.

사용자가 번역기를> 선택<하지 않으면 lpszName, lpszPath 및 pvOption의 콘텐츠는 터치되지 않습니다. SQLGetTranslator는 pcbNameOut 및 pcbPathOut을 0으로 설정하고 TRUE를 반환합니다.

사용자가 번역기를 선택하는 경우 SQLGetTranslator는 번역기의 설치 DLL에서 ConfigTranslator를 호출합니다. ConfigTranslator가 FALSE를 반환하면 SQLGetTranslator가 해당 대화 상자로 돌아갑니다. ConfigTranslator가 TRUE를 반환하면 SQLGetTranslator는 선택한 번역기 이름, 경로 및 번역 옵션과 함께 TRUE를 반환합니다.

관련 함수

추가 정보	참조
번역기 구성	ConfigTranslator
번역 특성 가져오기	SQLGetConnectAttr
번역 특성 설정	SQLSetConnectAttr