JetDeleteColumn2 함수
적용 대상: Windows | Windows Server
JetDeleteColumn2 함수
JetDeleteColumn2 함수는 ESE 데이터베이스 테이블에서 열을 삭제하고 grbit 옵션을 설정할 수 있도록 합니다.
Windows XP: JetDeleteColumn2 는 Windows XP에 도입되었습니다.
JET_ERR JET_API JetDeleteColumn2(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in const tchar* szColumnName,
__in const JET_GRBIT grbit
);
매개 변수
sesid
API 호출에 사용할 데이터베이스 세션 컨텍스트입니다.
tableid
삭제할 열이 들어 있는 테이블입니다.
szColumnName
삭제할 열의 이름입니다.
grbit
다음 옵션 중 0개 이상을 지정하는 비트 그룹입니다.
값 |
의미 |
---|---|
JET_bitDeleteColumnIgnoreTemplateColumns |
JET_bitDeleteColumIgnoreTemplateColumns 설정하면 API가 파생 테이블의 열만 삭제하려고 시도합니다. 해당 이름의 열이 기본 테이블에 있으면 무시됩니다. |
반환 값
이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. |
JET_errColumnInUse |
열이 현재 사용 중입니다. 현재 인덱스에서 사용할 수 있습니다. |
JET_errFixedDDL |
고정 DDL을 수정하려고 했습니다. |
JET_errFixedInheritedDDL |
szColumnName에서 라는 열이 템플릿 테이블에 있으며 템플릿 테이블의 DDL은 수정할 수 없습니다. |
JET_errInvalidName |
szColumnName에 잘못된 이름이 지정된 경우 반환될 수 있습니다. |
JET_errPermissionDenied |
테이블을 쓸 수 없습니다. 데이터베이스가 읽기 전용 모드로 열려 있는 경우 반환될 수 있습니다. |
JET_errTransReadOnly |
트랜잭션은 읽기 전용 트랜잭션입니다. |
설명
JetDeleteColumn을 호출하는 것은 grbit가 0으로 설정된 JetDeleteColumn2를 호출하는 것과 동일합니다.
요구 사항
요구 사항 | 값 |
---|---|
클라이언트 |
Windows Vista 또는 Windows XP가 필요합니다. |
서버 |
Windows Server 2008 또는 Windows Server 2003이 필요합니다. |
머리글 |
Esent.h에 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
유니코드 |
JetDeleteColumn2W(유니코드) 및 JetDeleteColumn2A(ANSI)로 구현됩니다. |