JetSetSystemParameter 함수
적용 대상: Windows | Windows Server
JetSetSystemParameter 함수
JetSetSystemParameter 함수는 데이터베이스 엔진의 다양한 구성 설정을 설정하는 데 사용됩니다.
JET_ERR JET_API JetSetSystemParameter(
__in_out_opt JET_INSTANCE* pinstance,
__in JET_SESID sesid,
__in unsigned long paramid,
__in JET_API_PTR lParam,
__in_opt JET_PCSTR szParam
);
매개 변수
pinstance
이 호출에 사용할 instance 지정합니다.
Windows 2000: Windows 2000의 경우 이 매개 변수는 무시되며 항상 NULL이어야 합니다.
Windows XP: Windows XP 이상 릴리스의 경우 이 매개 변수는 다소 오버로드됩니다. 엔진이 하나의 instance 지원되는 레거시 모드(Windows 2000 호환 모드)에서 작동하는 경우 이 매개 변수는 NULL이거나 JetInit에서 반환된 실제 instance 포함할 수 있습니다. 두 경우 모두 해당 instance 모든 시스템 매개 변수 설정을 읽습니다. 엔진이 다중 instance 모드에서 작동하는 경우 이 매개 변수는 NULL이거나 JetInit 또는 JetCreateIndex를 사용하여 만든 instance 대한 포인터일 수 있습니다. 이 매개 변수가 NULL 이면 전역 시스템 매개 변수 설정(또는 기본값)을 읽습니다. 이 매개 변수가 instance 경우 해당 instance 대한 시스템 매개 변수 설정을 읽습니다.
기술적으로 out 매개 변수이지만 이 API는 제공된 버퍼의 내용을 수정하지 않습니다.
sesid
이 호출에 사용할 세션을 지정합니다.
지정하면 지정된 instance 무시되고 세션과 연결된 instance 사용됩니다.
paramid
설정할 시스템 매개 변수의 ID입니다. 시스템 매개 변수 및 해당 속성의 전체 목록은 시스템 매개 변수를 참조하세요.
lParam
해당 시스템 매개 변수가 정수 형식인 경우 선택한 시스템 매개 변수에 대해 설정할 값을 제공합니다.
szParam
해당 시스템 매개 변수가 문자열 형식인 경우 선택한 시스템 매개 변수에 대한 값을 제공합니다.
반환 값
이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
|---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. Windows Vista: Windows Vista 이상 릴리스에서는 시스템 매개 변수 값을 변경하지 않고도 성공을 반환할 수 있습니다. 자세한 내용은 메타 매개 변수 항목의 JET_paramEnableAdvanced 시스템 매개 변수를 참조하세요. |
JET_errAlreadyInitialized |
instance JetInit 호출을 사용하여 초기화되었으며 결과적으로 이 작업을 수행할 수 없습니다. 값이 변경된 후 시스템 매개 변수를 구성하려고 하면 데이터베이스 엔진의 상태에 영향을 줄 수 없는 경우 JetSetSystemParameter 에서 이 문제가 발생할 수 있습니다. |
JET_errClientRequestToStopJetService |
JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다. |
JET_errIndexTuplesInvalidLimits |
지정된 튜플 인덱스 매개 변수가 잘못되었습니다. 이 오류는 JET_paramIndexTuplesLengthMin,JET_paramIndexTuplesLengthMax 또는 JET_paramIndexTuplesToIndexMax 잘못된 값으로 설정하는 경우에만 JetSetSystemParameter에서 반환될 수 있습니다. Windows XP 및 Windows Server 2003: 이는 Windows XP 및 Windows Server 2003에서만 발생할 수 있습니다. |
JET_errInitInProgress |
세션과 연결된 instance 초기화되므로 작업을 완료할 수 없습니다. |
JET_errInstanceUnavailable |
세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. Windows XP: 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다. |
JET_errInvalidParameter |
제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다. 이는 다음과 같은 경우 JetSetSystemParameter에 대해 발생할 수 있습니다.
|
JET_errInvalidPath |
지정된 파일 시스템 경로가 잘못되었습니다. 이 오류는 파일 시스템 경로를 나타내는 시스템 매개 변수를 설정할 때만 JetSetSystemParameter 에서 반환될 수 있습니다. 예를 들어 JET_paramSystemPath 이 오류를 반환할 수 있습니다. |
JET_errNotInitialized |
세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다. |
JET_errRestoreInProgress |
세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다. |
JET_errTermInProgress |
세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다. |
JET_errInvalidSesid |
세션 핸들이 잘못되었거나 닫힌 세션을 참조합니다. 이 오류는 모든 상황에서 반환되지 않습니다. 핸들은 최상의 노력으로만 유효성이 검사됩니다. |
JET_errInvalidInstance |
instance 핸들이 잘못되었거나 종료된 instance 나타냅니다. 이 오류는 모든 상황에서 반환되지 않습니다. 핸들은 최상의 노력으로만 유효성이 검사됩니다. Windows Vista: 이 오류는 Windows Vista 이상 릴리스에서만 반환됩니다. |
성공하면 시스템 매개 변수에 대한 설정이 제공된 값으로 설정됩니다.
실패 시 시스템 매개 변수에 대한 설정은 변경되지 않은 상태로 유지됩니다.
설명
JetSetSystemParameter 는 각 시스템 매개 변수에 대해 선택한 설정의 유효성을 검사하는 잘못된 작업을 수행합니다. 좋은 설정을 적용하려면 이 유효성 검사에 의존하지 않도록 주의해야 합니다. 각 시스템 매개 변수의 설명에 주의를 기울이고 적절한 시스템 매개 변수 설정에 대한 지침을 따르세요.
데이터베이스 엔진이 의도한 대로 작동하도록 항상 설정해야 하는 시스템 매개 변수 집합이 있습니다. 특히 데이터베이스 엔진에서 사용하는 파일의 실제 레이아웃에 영향을 주는 시스템 매개 변수는 항상 설정해야 합니다. 자세한 내용은 시스템 매개 변수를 참조하세요.
모든 시스템 매개 변수에는 기본값이 있습니다. 이러한 기본값은 시간이 지남에 따라 진화했으며 매우 임의적입니다. 애플리케이션이 모든 기본값을 평가하여 적절한지 확인하는 것이 좋습니다. 적절하지 않은 경우 애플리케이션에서 구성해야 합니다. 이러한 매개 변수 중 상당수가 데이터베이스 엔진의 안정성, 성능 및 리소스 사용률에 큰 영향을 미칠 수 있으므로 이는 중요합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
클라이언트 |
Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다. |
서버 |
Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다. |
머리글 |
Esent.h에 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |
유니코드 |
JetSetSystemParameterW(유니코드) 및 JetSetSystemParameterA(ANSI)로 구현됩니다. |
참고 항목
JET_API_PTR
JET_ERR
JET_INSTANCE
JET_SESID
JetCreateInstance
JetGetSystemParameter
JetInit
시스템 매개 변수
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기