다음을 통해 공유


SQLWriteFileDSN 함수

규칙
버전 소개: ODBC 3.0

요약
SQLWriteFileDSN 은 파일 DSN에 정보를 씁니다.

구문

  
BOOL SQLWriteFileDSN(  
     LPCSTR     lpszFileName,  
     LPCSTR     lpszAppName,  
     LPCSTR     lpszKeyName,  
     LPCSTR     lpszString);  

인수

lpszFileName
[입력] 파일 DSN의 이름에 대한 포인터입니다. DSN 확장명은 DSN 확장명이 아직 없는 모든 파일 이름에 추가됩니다.

lpszAppName
[입력] 애플리케이션 이름에 대한 포인터입니다. ODBC 섹션에 대한 "ODBC"입니다.

lpszKeyName
[입력] 읽을 키의 이름에 대한 포인터입니다. 예약된 키워드는 "주석"을 참조하세요.

lpszString
[출력] 쓸 키와 연결된 문자열을 가리켰습니다. 이 인수가 가리키는 문자열의 최대 길이는 32,767바이트입니다.

반품

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

진단

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

*pfErrorCode Error 설명
ODBC_ERROR_GENERAL_ERR 일반 설치 관리자 오류 특정 설치 관리자 오류가 없는 오류가 발생했습니다.
ODBC_ERROR_INVALID_PATH 잘못된 설치 경로 lpszFileName 인수에 지정된 파일 이름의 경로가 잘못되었습니다.
ODBC_ERROR_INVALID_REQUEST_TYPE 잘못된 요청 유형 lpszAppName, lpszKeyName 또는 lpszString 인수가 NULL이었습니다.

주석

ODBC는 연결 정보를 저장할 섹션 이름 [ODBC]를 예약합니다. 이 섹션의 예약된 키워드는 SQLDriverConnect연결 문자열에 대해 예약된 키워드와 동일합니다. (자세한 내용은 다음을 참조하세요 .SQLDriverConnect 함수 설명입니다.)

애플리케이션은 이러한 예약된 키워드를 사용하여 파일 DSN에 직접 정보를 쓸 수 있습니다. 애플리케이션이 파일 DSN과 연결된 DSN이 없는 연결 문자열을 만들거나 수정하려는 경우 [ODBC] 섹션의 예약된 연결 문자열 키워드에 대해 SQLWriteFileDSN을 호출할 수 있습니다.

lpszString 인수가 null 포인터이면 lpszKeyName 인수가 가리키는 키워드가 .dsn 파일에서 삭제됩니다. lpszStringlpszKeyName 인수가 모두 null 포인터인 경우 lpszAppName 인수가 가리키는 섹션이 .dsn 파일에서 삭제됩니다.

추가 정보 참조
파일 DSN에서 정보 읽기 SQLReadFileDSN