Api.RetrieveColumn 메서드(JET_SESID, JET_TABLEID, JET_COLUMNID, RetrieveColumnGrbit, JET_RETINFO)

아티클
06/13/2023

현재 레코드에서 단일 열 값을 검색합니다. 레코드는 커서의 현재 위치에 있는 인덱스 항목과 연결된 레코드입니다. 또는 이 함수는 커서 복사 버퍼에 만들어지는 레코드에서 열을 검색할 수 있습니다. 이 함수는 현재 레코드를 참조하는 인덱스 항목에서 열 데이터를 검색할 수도 있습니다. 실제 열 값을 검색하는 것 외에도 JetRetrieveColumn을 사용하여 열 크기를 검색한 후 열 데이터 자체를 검색하여 애플리케이션 버퍼의 크기를 적절하게 지정할 수 있습니다.

네임스페이스:Microsoft.Isam.Esent.Interop
어셈블리: Microsoft.Isam.Esent.Interop(Microsoft.Isam.Esent.Interop.dll)

구문

'Declaration
Public Shared Function RetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As Byte()
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As Byte()

returnValue = Api.RetrieveColumn(sesid, _
    tableid, columnid, grbit, retinfo)

public static byte[] RetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    RetrieveColumnGrbit grbit,
    JET_RETINFO retinfo
)

매개 변수

sesid
형식: Microsoft.Isam.Esent.Interop.JET_SESID

사용할 세션입니다.

tableid
형식: Microsoft.Isam.Esent.Interop.JET_TABLEID

열을 검색할 커서입니다.

columnid
형식: Microsoft.Isam.Esent.Interop.JET_COLUMNID

검색할 columnid입니다.

grbit
형식: Microsoft.Isam.Esent.Interop.RetrieveColumnGrbit

열 옵션을 검색합니다.

retinfo
형식: Microsoft.Isam.Esent.Interop.JET_RETINFO

pretinfo가 NULL로 제공되면 함수는 itagSequence가 1이고 ibLongValue가 0인 것처럼 동작합니다. 이렇게 하면 열 검색에서 다중값 열의 첫 번째 값을 검색하고 오프셋 0에서 긴 데이터를 검색합니다.