JetEnableMultiInstance 함수

적용 대상: Windows | Windows Server

JetEnableMultiInstance 함수

JetEnableMultiInstance 함수는 동일한 프로세스에서 여러 인스턴스와 함께 사용할 데이터베이스 엔진을 구성합니다. 전역 시스템 매개 변수의 선택적 배열은 첫 번째 호출자가 다중 instance 모드로 변경할 수 있도록 하는 데 사용할 수 있습니다.

Windows XP: JetEnableMultiInstance 가 Windows XP에 도입되었습니다.

    JET_ERR JET_API JetEnableMultiInstance(
      __in_opt      JET_SETSYSPARAM* psetsysparam,
      __in_opt      unsigned long csetsysparam,
      __out_opt     unsigned long* pcsetsucceed
    );

매개 변수

psetsysparam

이 호출의 결과로 엔진이 다중 instance 모드로 전환되는 경우에만 설정할 전역 시스템 매개 변수의 배열입니다. csetsysparam이 0이면 psetsysparam이 무시됩니다.

csetsysparam

이 호출의 결과로 엔진이 다중 instance 모드로 전환되는 경우에만 설정할 전역 매개 변수 배열의 요소 수입니다. csetsysparam이 0이면 psetsysparam이 무시됩니다.

pcsetsucceed

이 호출의 결과로 성공적으로 구성된 전역 시스템 매개 변수 수에 대한 포인터입니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errIndexTuplesInvalidLimits	지정된 튜플 인덱스 매개 변수가 허용되지 않았습니다. 이 오류는 JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax 또는JET_paramIndexTuplesToIndexMax 잘못된 값으로 설정할 때만 JetEnableMultiInstance에서 반환할 수 있습니다. Windows XP: 이 반환 값은 Windows XP에 도입되었습니다.
JET_errInvalidPath	지정된 파일 시스템 경로가 잘못되었습니다. 이 오류는 파일 시스템 경로를 나타내는 시스템 매개 변수를 설정할 때만 JetEnableMultiInstance 에서 반환할 수 있습니다. 예를 들어 JET_paramSystemPath 이 오류를 반환할 수 있습니다.
JET_errRunningInOneInstanceMode	데이터베이스 엔진이 단일 instance 모드(Windows 2000 호환 모드)에서 작동하는 경우 잘못된 작업이므로 작업이 실패했습니다.
JET_errSystemParamsAlreadySet	엔진이 이미 다중 instance 모드에 있으므로 JetEnableMultiInstance가 실패했습니다. 참고 시스템 매개 변수가 지정되지 않은 경우에도 발생합니다.

이 함수가 성공하면 데이터베이스 엔진이 다중 instance 모드에서 실행되도록 구성됩니다. 또한 엔진이 전역 시스템 매개 변수의 선택적 목록으로 성공적으로 구성되었습니다.

이 함수가 실패하면 데이터베이스 엔진은 현재 모드로 유지됩니다. pcsetsucceed가 0이 아닌 경우 해당 시스템 매개 변수 수는 설정된 상태로 유지됩니다.

설명

이 함수는 애플리케이션이 동일한 프로세스의 다중 사용자 시나리오에서 사용할 데이터베이스 엔진을 설정할 때 지정된 시스템 매개 변수 집합을 원자성으로 구성해야 하는 경우에만 사용해야 합니다. 다른 동기화 방법을 사용할 수 있는 경우 JetCreateInstance 및 JetSetSystemParameter 를 별도로 호출하는 것이 좋습니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista 또는 Windows XP가 필요합니다.
서버	Windows Server 2008 또는 Windows Server 2003이 필요합니다.
머리글	Esent.h에서 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.
유니코드	JetEnableMultiInstanceW(유니코드) 및 JetEnableMultiInstanceA(ANSI)로 구현됩니다.

참고 항목

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter