SQLValidDSN 함수

규칙
버전 소개: ODBC 2.0

요약
SQLValidDSN 은 이름이 시스템 정보에 추가되기 전에 데이터 원본 이름의 길이와 유효성을 확인합니다.

구문

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);  

인수

lpszDSN
[입력] 확인할 데이터 원본 이름입니다.

반품

데이터 원본 이름이 유효한 경우 함수는 TRUE를 반환합니다. 데이터 원본 이름이 잘못되었거나 함수 호출에 실패한 경우 FALSE를 반환합니다.

진단

SQLValidDSN이 FALSE를 반환하면 SQLInstallerError를 호출하여 연결된 *pfErrorCode 값을 가져올 수 있습니다. *pfErrorCode는 데이터 원본 이름이 잘못되어 FALSE가 반환된 경우가 아니라 함수 호출이 실패한 경우에만 반환됩니다. 다음 표에서는 SQLInstallerError에서 반환할 수 있는 *pfErrorCode 값을 나열하고 이 함수의 컨텍스트에서 각각에 대해 설명합니다.

*pfErrorCode	Error	설명
ODBC_ERROR_GENERAL_ERR	일반 설치 관리자 오류	특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_OUT_OF_MEM	메모리 부족	메모리 부족으로 인해 설치 관리자가 함수를 수행할 수 없습니다.

주석

SQLValidDSN 은 데이터 원본 이름의 길이와 데이터 원본 이름에 있는 개별 문자의 유효성을 확인하기 위해 드라이버 의 ConfigDSN 에 의해 호출됩니다. Sqlext.h에 정의된 대로 이름의 길이가 SQL_MAX_DSN_LENGTH보다 큰지 확인합니다. (데이터 원본 이름의 길이도 다음을 통해 확인됨) SQLWriteDSNToIni.) SQLValidDSN 은 데이터 원본 이름에 다음 잘못된 문자가 포함되어 있는지 확인합니다.

[ ] { } ( ) , ; ? * = ! @ \

관련 함수

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