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