JetGetErrorInfoW 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JetGetErrorInfoW 함수

JetGetErrorInfoW 함수는 데이터베이스 엔진의 BAS_.

참고: 이 설명서는 확장 가능한 스토리지 엔진의 예비 릴리스를 기반으로 합니다. 이 정보는 변경될 수 있습니다.

JET_ERR JET_API JetGetErrorInfoW( 
    _In_opt_ void *                      pvContext, 
    _Out_writes_bytes_( cbMax ) void *   pvResult, 
    _In_ unsigned long                   cbMax, 
    _In_ unsigned long                   InfoLevel, 
    _In_ JET_GRBIT                       grbit );

매개 변수

pvContext

확장된 오류 정보가 필요한 컨텍스트 또는 오류 값입니다. 전달된 값은 InfoLevel 매개 변수 값에 따라 달라집니다.

pvResult

정보를 받을 버퍼에 대한 포인터입니다. 버퍼의 형식은 InfoLevel 매개 변수 값에 따라 달라집니다. 버퍼를 적절하게 정렬하도록 호출자를 구성해야 합니다.

cbMax

전달되는 pvResult 구조체의 최대 크기입니다.

InfoLevel

오류 정보/컨텍스트에 대해 검색할 정보 유형은 pvContext 매개 변수에 의해 지정됩니다. pvResult에 저장된 데이터의 형식은 InfoLevel에 따라 달라집니다.

다음 표에서는 이 매개 변수에 대해 가능한 값을 나열합니다.

값	의미
JET_ErrorInfoSpecificErr	pvContext 는 JET_ERR/오류 코드로 해석되고 , pvResult 는 JET_ERRINFOBASIC_W 해석되고, JET_ERRINFOBASIC_W 구조체의 필드는 적절하게 채워집니다.

grbit

예약되어 있습니다.

반환 값

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

반환 코드	설명
JET_errSuccess	작업이 성공적으로 완료되었습니다.
JET_errInvalidParameter	제공된 매개 변수 중 하나에 예기치 않은 값이 포함되거나 다른 매개 변수의 값과 결합될 때 의미가 없는 값이 포함되어 있습니다. 이는 JetGetErrorInfo 에서 다음이 발생할 때 발생할 수 있습니다. 지정한 InfoLevel 매개 변수 값이 잘못되었습니다. 지정된 grbit 값이 잘못되었습니다. 지정된 pvResult 매개 변수 버퍼의 cbMax 값이 이 InfoLevel 매개 변수의 출력에 필요한 크기보다 작습니다. InfoLevel = JET_ErrorInfoSpecificErr 전달된 JET_ERR 값을 엔진에 알 수 없습니다.
JET_errDisabledFunctionality	이 Windows SKU가 이 함수를 지원하지 않으면 이 오류가 반환됩니다.

반환 코드

설명

JET_errSuccess

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

JET_errInvalidParameter

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

지정한 InfoLevel 매개 변수 값이 잘못되었습니다.
지정된 grbit 값이 잘못되었습니다.
지정된 pvResult 매개 변수 버퍼의 cbMax 값이 이 InfoLevel 매개 변수의 출력에 필요한 크기보다 작습니다.
InfoLevel = JET_ErrorInfoSpecificErr 전달된 JET_ERR 값을 엔진에 알 수 없습니다.

JET_errDisabledFunctionality

이 Windows SKU가 이 함수를 지원하지 않으면 이 오류가 반환됩니다.

성공하면 요청된 오류 컨텍스트/값에 적합한 출력 버퍼가 요청된 확장 오류 정보로 설정됩니다.

실패 시 출력 버퍼의 상태가 정의되지 않습니다.

설명

JET_ERRINFOBASIC_W 함수 및 JET_ERRCAT 상수 그룹에는 InfoLevel = JET_ErrorInfoSpecificErr 대해 반환되는 확장된 오류 정보에 대한 설명서가 포함되어 있습니다.

요구 사항

요구 사항	값
클라이언트	Windows 8 필요합니다.
서버	Windows 8 서버가 필요합니다.
머리글	Esent.h에서 선언되었습니다.
라이브러리	ESENT.lib를 사용합니다.
DLL	ESENT.dll 필요합니다.
유니코드	참고: JetGetErrorInfoW (유니코드)만 구현됩니다. 이 API에는 A(ANSI) 버전이 없습니다.

JetGetErrorInfoW 함수