JetCreateIndex 함수

적용 대상: Windows | Windows Server

JetCreateIndex 함수

JetCreateIndex 함수를 사용하면 특정 데이터를 신속하게 찾는 데 사용할 수 있는 ESE(Extensible Storage Engine) 데이터베이스에서 데이터 인덱스를 만들 수 있습니다.

    JET_ERR JET_API JetCreateIndex(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_PCSTR szIndexName,
      __in          JET_GRBIT grbit,
      __in          const tchar* szKey,
      __in          unsigned long cbKey,
      __in          unsigned long lDensity
    );

매개 변수

sesid

특정 API 호출에 사용할 데이터베이스 세션 컨텍스트입니다.

tableid

인덱스가 만들어질 테이블입니다.

szIndexName

만들 인덱스의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

인덱스 이름은 다음 지침을 따라야 합니다.

• 종료 null 문자를 포함하지 않고 JET_cbNameMost 보다 적은 문자를 포함해야 합니다.

• 다음 범주의 문자만 포함해야 합니다. 0~9, A~Z, a~z 및 "!"를 제외한 모든 문장 부호 문자 (느낌표), ","(쉼표), "["(여는 대괄호) 및 "]" (닫는 대괄호) 즉, ASCII 문자가 0x20, 0x2d 통해 0x22, 0x5a, 0x5c 및 0x7f 통해 0x5d 통해 0x2f.

• 공백으로 시작해서는 안됩니다.

• 공백이 아닌 문자를 하나 이상 포함해야 합니다.

grbit

특정 호출에 사용할 옵션이 포함된 비트 그룹입니다. 이 매개 변수는 JET_INDEXCREATE 구조체에 있는 0개 이상의 옵션을 포함할 수 있습니다.

szKey

null로 구분된 토큰의 이중 null로 끝나는 문자열에 대한 포인터입니다.

이 매개 변수에 대한 자세한 내용은 JET_INDEXCREATE 구조를 참조하세요.

cbKey

종료되는 두 null 문자를 포함하여 szKey 매개 변수의 길이(바이트)입니다.

lDensity

초기 인덱스 B+ 트리의 백분율 밀도입니다.

이 매개 변수에 대한 자세한 내용은 JET_INDEXCREATE 구조를 참조하세요.

반환 값

이 함수는 다음 표에 나열된 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.

반환 코드	의미
JET_errSuccess	작업이 성공적으로 완료되었습니다.

JetCreateIndex 함수에서 반환할 수 있는 추가 오류 목록은 JetCreateIndex2를 참조하세요.

설명

JetCreateIndex 함수를 호출하는 것은 JetCreateIndex의 매개 변수와 동일한 설정을 포함하는 JET_INDEXCREATE 구조체와 cIndexCreate 매개 변수가 1인 JetCreateIndex2 함수를 호출하는 것과 동일합니다. JetCreateIndex에 해당 매개 변수가 없는 JET_INDEXCREATE 구조체의 필드의 경우 값이 0으로 간주됩니다.

JetCreateIndex는 JetCreateIndex2로 대체되었습니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
헤더	Esent.h에서 선언됩니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.
Unicode	JetCreateIndexW(유니코드) 및 JetCreateIndexA(ANSI)로 구현됩니다.

참고 항목

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_INDEXCREATE
JetCreateIndex2
JetCreateTableColumnIndex
JetCreateTableColumnIndex2