JetGetLS 함수
적용 대상: Windows | Windows Server
JetGetLS 함수
JetGetLS 함수를 사용하면 애플리케이션이 커서 또는 해당 커서와 연결된 테이블과 연결된 Local Storage라는 컨텍스트 핸들을 검색할 수 있습니다. 이 컨텍스트 핸들은 이전에 JetSetLS를 사용하여 설정되었어야 합니다. JetGetLS 를 사용하여 커서 또는 테이블에 대한 현재 컨텍스트 핸들을 동시에 가져오고 해당 컨텍스트 핸들을 다시 설정할 수도 있습니다.
Windows XP: JetGetLS 는 Windows XP에 도입되었습니다.
JET_ERR JET_API JetGetLS(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__out JET_LS* pls,
__in JET_GRBIT grbit
);
매개 변수
sesid
이 호출에 사용할 세션입니다.
tableid
이 호출에 사용할 커서입니다.
pls
현재 커서 또는 테이블과 연결된 컨텍스트 핸들을 수신하는 출력 버퍼입니다.
grbit
다음 옵션 중 0개 이상을 지정하는 비트 그룹입니다.
값 |
의미 |
|---|---|
JET_bitLSCursor |
지정된 커서와 연결된 컨텍스트 핸들을 검색해야 했음을 나타냅니다. JET_bitLSCursor 또는 JET_bitLSTable 지정되지 않은 경우 JET_bitLSCursor 추정됩니다. 이 옵션은 JET_bitLSTable 사용할 수 없습니다. 이 작업이 시도되면 JET_errInvalidgrbit 작업이 실패합니다. |
JET_bitLSTable |
지정된 커서가 포함된 테이블에 연결된 컨텍스트 핸들을 검색해야 했음을 나타냅니다. JET_bitLSCursor 이 옵션을 사용하는 것은 불법입니다. 이 작업이 시도되면 JET_errInvalidgrbit 작업이 실패합니다. |
JET_bitLSReset |
선택한 개체에 대한 컨텍스트 핸들을 JET_LSNil 다시 설정해야 했음을 나타냅니다. 컨텍스트 핸들의 현재 값은 출력 버퍼에 반환됩니다. |
반환 값
이 함수는 다음 반환 코드 중 하나를 사용하여 JET_ERR 데이터 형식을 반환합니다. 가능한 ESE 오류에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류 및 오류 처리 매개 변수를 참조하세요.
반환 코드 |
설명 |
|---|---|
JET_errSuccess |
작업이 성공적으로 완료되었습니다. |
JET_errClientRequestToStopJetService |
JetStopService 호출로 인해 세션과 연결된 instance 모든 작업이 중단되었으므로 작업을 완료할 수 없습니다. |
JET_errInstanceUnavailable |
세션과 연결된 instance 해당 데이터의 무결성을 보호하기 위해 모든 데이터에 대한 액세스를 해지해야 하는 심각한 오류가 발생하여 작업을 완료할 수 없습니다. 이 오류는 Windows XP 이상 릴리스에서만 반환됩니다. |
JET_errInvalidgrbit |
요청된 옵션 중 하나가 잘못되었거나, 잘못된 방식으로 사용되었거나, 구현되지 않았습니다. 이는 JET_bitLSCursor 및 JET_bitLSTable 모두 설정된 경우 JetGetLS 에 대해 발생할 수 있습니다. |
JET_errLSNotSet |
현재 요청된 개체와 연결된 컨텍스트 핸들이 없으므로 컨텍스트 핸들을 반환할 수 없습니다. 참고 JET_bitLSReset 지정되었지만 요청된 개체와 연결된 컨텍스트 핸들이 없으면 이 오류가 반환되지 않습니다. |
JET_errNotInitialized |
세션과 연결된 instance 아직 초기화되지 않았기 때문에 작업을 완료할 수 없습니다. |
JET_errRestoreInProgress |
세션과 연결된 instance 복원 작업이 진행 중이므로 작업을 완료할 수 없습니다. |
JET_errTermInProgress |
세션과 연결된 instance 종료 중이므로 작업을 완료할 수 없습니다. |
성공하면 컨텍스트 핸들이 요청된 개체에서 성공적으로 검색되었습니다. JET_bitLSReset 지정한 경우 해당 컨텍스트 핸들도 개체에서 성공적으로 제거되었습니다. 데이터베이스 상태는 변경되지 않습니다.
실패 시 요청된 개체의 상태가 변경되지 않았습니다. 데이터베이스 상태는 변경되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
클라이언트 |
Windows Vista 또는 Windows XP가 필요합니다. |
서버 |
Windows Server 2008 또는 Windows Server 2003이 필요합니다. |
머리글 |
Esent.h에 선언되었습니다. |
라이브러리 |
ESENT.lib를 사용합니다. |
DLL |
ESENT.dll 필요합니다. |