JetSetSessionParameter 함수

  • 아티클

적용 대상: Windows | Windows Server

JetSetSessionParameter 함수는 데이터베이스 엔진을 구성합니다.

JET_ERR JET_API JetSetSessionParameter (
  __in_opt      JET_SESID sesid,
  __in          unsigned long sesparamid,
  __in_read_bytes_opt_(cbParam)  void* pvParam,
  __in          unsigned long cbParam
);

매개 변수

sesid

이 호출에 사용할 세션을 지정합니다.

지정하면 지정된 instance 무시되고 세션과 연결된 instance 사용됩니다.

sesparamid

설정할 세션 매개 변수의 ID입니다.

pvParam

이 세션 매개 변수에 설정할 데이터입니다.

cbParam

제공된 데이터의 크기입니다.

반환 값

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

반환 코드

설명

JET_errSuccess

작업이 성공적으로 완료되었습니다.

JET_errAlreadyInitialized

instance JetInit 함수 호출을 사용하여 초기화되었으며 결과적으로 이 작업을 수행할 수 없습니다. 이는 매개 변수 값이 변경된 후 시스템 매개 변수를 구성하려고 하면 데이터베이스 엔진의 상태에 더 이상 영향을 주지 않을 때 발생할 수 있습니다.

JET_errClientRequestToStopJetService

JetStopService 함수 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다.

JET_errIndexTuplesInvalidLimits

지정된 튜플 인덱스 매개 변수가 잘못되었습니다. 이 오류는 JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax 또는 JET_paramIndexTuplesToIndexMax 매개 변수가 잘못된 값으로 설정된 경우에만 반환 됩니다. 이러한 매개 변수에 대한 자세한 내용은 인덱스 매개 변수를 참조하세요.

JET_errInitInProgress

세션과 연결된 instance 초기화되므로 작업을 완료할 수 없습니다.

JET_errInstanceUnavailable

세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다.

JET_errInvalidParameter

제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다. 이 문제는 다음이 발생할 때 발생할 수 있습니다.

  • 지정된 시스템 매개 변수 ID가 잘못되었거나 지원되지 않습니다.

  • 길이가 매개 변수의 법적 범위를 벗어난 문자열로 문자열 반환 시스템 매개 변수를 설정하려고 했습니다.

  • 절대 경로 표현의 길이가 해당 매개 변수의 법적 범위를 벗어난 파일 경로로 문자열 반환 시스템 매개 변수를 설정하려고 했습니다.

  • 매개 변수의 법적 범위를 벗어난 정수로 정수 반환 시스템 매개 변수를 설정하려고 했습니다.

  • null JET_UNICODEINDEX 포인터, 잘못된 LCID 또는 지원되지 않는 LCMapString 플래그 집합으로 JET_paramUnicodeIndexDefault 설정하려고 했습니다.

  • 지정된 시스템 매개 변수는 읽기 전용이므로 설정할 수 없습니다.

  • JetInit 함수가 호출되고 데이터베이스 엔진이 단일 instance 모드이고 세션이 지정되지 않은 후 시스템 매개 변수를 설정하려고 했습니다.

  • 지정된 시스템 매개 변수는 전역 매개 변수이며 해당 시스템 매개 변수에 대한 instance 특정 값을 설정하려고 했습니다.

  • 지정된 시스템 매개 변수는 instance 단위이며 해당 시스템 매개 변수에 대한 전역 값을 설정하려고 했습니다.

JET_errInvalidPath

지정된 파일 시스템 경로가 잘못되었습니다. 이 오류는 파일 시스템 경로를 나타내는 시스템 매개 변수를 설정할 때만 JetSetSessionParameter 에서 반환될 수 있습니다. 예를 들어 JET_paramSystemPath 매개 변수는 이 오류를 반환할 수 있습니다. 이 매개 변수에 대한 자세한 내용은 트랜잭션 로그 매개 변수를 참조하세요.

JET_errNotInitialized

세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다.

JET_errRestoreInProgress

세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다.

JET_errTermInProgress

세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다.

JET_errInvalidSesid

세션 핸들이 잘못되었거나 닫힌 세션을 참조합니다.

이 오류는 모든 상황에서 반환되지 않습니다. 핸들은 최상의 노력으로만 유효성이 검사됩니다.

JET_errInvalidInstance

instance 핸들이 잘못되었거나 종료된 instance 참조합니다.

이 오류는 모든 상황에서 반환되지 않습니다. 핸들은 최상의 노력으로만 유효성이 검사됩니다.

성공하면 시스템 매개 변수가 제공된 값으로 설정됩니다.

실패 시 시스템 매개 변수 값은 변경되지 않은 상태로 유지됩니다.

요구 사항

요구 사항 값

클라이언트

Windows 8 필요합니다.

서버

Windows Server 2012 필요합니다.

머리글

Esent.h에 선언되었습니다.

라이브러리

ESENT.lib를 사용합니다.

DLL

ESENT.dll 필요합니다.

추가 정보

JET_API_PTR
JET_ERR
JET_INSTANCE
JET_SESID
JetCreateInstance
JetGetSystemParameter
JetInit
시스템 매개 변수