JetGetInstanceInfo 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetGetInstanceInfo 함수

JetGetInstanceInfo 함수는 실행 중인 인스턴스에 대한 정보를 검색합니다.

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

    JET_ERR JET_API JetGetInstanceInfo(
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo
    );

매개 변수

pcInstanceInfo

paInstanceInfo에 저장된 요소 수를 수신하는 버퍼에 대한 포인터입니다.

paInstanceInfo

구조체 배열의 첫 번째 요소 주소를 수신하는 버퍼에 대한 포인터입니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errInvalidParameter	제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다. 이 오류는 다음과 같은 경우 JetGetInstanceInfo 에서 반환됩니다. pcInstanceInfo 또는 paInstanceInfo 는 NULL입니다.
JET_errOutOfMemory	요청을 처리할 메모리가 부족합니다.

반환 코드

설명

JET_errSuccess

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

JET_errInvalidParameter

제공된 매개 변수 중 하나에 예기치 않은 값이 포함되어 있거나 다른 매개 변수의 값과 결합할 때 의미가 없는 값이 포함되어 있습니다. 이 오류는 다음과 같은 경우 JetGetInstanceInfo 에서 반환됩니다.

pcInstanceInfo 또는 paInstanceInfo 는 NULL입니다.

JET_errOutOfMemory

요청을 처리할 메모리가 부족합니다.

설명

데이터베이스 엔진은 JET_INSTANCE_INFO 구조의 배열을 할당합니다. 호출자는 JetFreeBuffer를 사용하여 이 메모리를 해제할 책임이 있습니다.

활성 인스턴스가 없으면 JetGetInstanceInfo 는 JET_errSuccess 반환하고 pcInstanceInfo 는 0 값을 받습니다.

요구 사항

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

참고 항목

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer

JetGetInstanceInfo 함수