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 |
제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다. 이 문제는 다음이 발생할 때 발생할 수 있습니다.
|
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
시스템 매개 변수