JET_ENUMCOLUMN 구조체
적용 대상: Windows | Windows Server
JET_ENUMCOLUMN 구조체
JET_ENUMCOLUMN 구조체는 JetEnumerateColumns 함수를 사용할 때 레코드의 열 값을 열거합니다. JetEnumerateColumns는JET_ENUMCOLUMN 구조체의 배열을 반환합니다. 배열은 해당 API에 제공된 재할당 호환 콜백을 사용하여 할당된 메모리에 반환됩니다.
typedef struct {
JET_COLUMNID columnid;
JET_ERR err;
union {
struct {
unsigned long cEnumColumnValue;
JET_ENUMCOLUMNVALUE rgEnumColumnValue;
};
struct {
unsigned long cbData;
void* pvData;
};
};
} JET_ENUMCOLUMN;
멤버
columnid
열거된 열 ID입니다.
err
열 상태 열거로 인해 발생하는 코드입니다.
오류 코드 |
의미 |
---|---|
JET_errBadColumnId |
열 ID가 열 ID의 법적 제한을 벗어났습니다. |
JET_errColumnNotFound |
열 ID로 설명된 열이 테이블에 없습니다. |
JET_wrnColumnNull |
이 열의 모든 값은 NULL입니다. |
JET_wrnColumnPresent |
JET_bitEnumeratePresenceOnly 지정되었으며 이 열에 대해 NULL이 아닌 열 값이 하나 이상 반환되었습니다. |
JET_wrnColumnSingleValue |
JET_bitEnumerateCompressOutput 지정되었으며 이 열에 대해 NULL이 아닌 열 값이 정확히 하나 반환되었습니다. 결과적으로 압축된 형식의 JET_ENUMCOLUMN 반환되었습니다. 자세한 내용은 JET_ENUMCOLUMN 참조하세요. |
JET_wrnColumnSkipped |
이 JET_ENUMCOLUMN 구조체에 해당하는 JET_ENUMCOLUMNID 구조체의 열 ID는 0입니다. |
cEnumColumnValue
열에 대해 열거된 열 값의 배열입니다. 출력 버퍼는 JetEnumerateColumns에 제공된 재할당 호환 콜백을 사용하여 할당된 메모리에 반환됩니다.
이 출력 버퍼는 열 상태 코드가 JET_wrnColumnSingleValue 같지 않을 때 사용됩니다. 자세한 내용은 JetEnumerateColumns를 참조하세요.
"err != JET_wrnColumnSingleValue"이면 반환됩니다.
rgEnumColumnValue
열에 대해 열거된 열 값의 배열입니다. 출력 버퍼는 JetEnumerateColumns에 제공된 재할당 호환 콜백을 사용하여 할당된 메모리에 반환됩니다.
이 출력 버퍼는 열 상태 코드가 JET_wrnColumnSingleValue 같지 않을 때 사용됩니다. 자세한 내용은 JetEnumerateColumns를 참조하세요.
"err != JET_wrnColumnSingleValue"이면 반환됩니다.
cbData
열에 대해 열거된 열 값입니다.
출력 버퍼는 JetEnumerateColumns에 제공된 재할당 호환 콜백을 사용하여 할당된 메모리에 반환됩니다.
이 출력 버퍼는 열 상태 코드가 JET_wrnColumnSingleValue 경우에만 사용됩니다. 자세한 내용은 JetEnumerateColumns를 참조하세요.
"err == JET_wrnColumnSingleValue" 경우 반환됩니다.
pvData
열에 대해 열거된 열 값입니다.
출력 버퍼는 JetEnumerateColumns에 제공된 재할당 호환 콜백을 사용하여 할당된 메모리에 반환됩니다.
이 출력 버퍼는 열 상태 코드가 JET_wrnColumnSingleValue 경우에만 사용됩니다. 자세한 내용은 JetEnumerateColumns를 참조하세요.
"err == JET_wrnColumnSingleValue" 경우 반환됩니다.
요구 사항
요구 사항 | 값 |
---|---|
클라이언트 |
Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다. |
서버 |
Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다. |
머리글 |
Esent.h에 선언되었습니다. |
참고 항목
JET_COLUMNID
JET_ERR
JET_ENUMCOLUMNID
JET_ENUMCOLUMNVALUE
JetEnumerateColumns
realloc