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 파일에서 삭제됩니다. lpszString 및 lpszKeyName 인수가 모두 null 포인터인 경우 lpszAppName 인수가 가리키는 섹션이 .dsn 파일에서 삭제됩니다.

관련 함수

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