Api.JetRetrieveColumn 메서드(JET_SESID, JET_TABLEID, JET_COLUMNID, Byte, Int32, Int32, RetrieveColumnGrbit, JET_RETINFO)

아티클
06/13/2023

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

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

구문

'Declaration
Public Shared Function JetRetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    data As Byte(), _
    dataSize As Integer, _
    <OutAttribute> ByRef actualDataSize As Integer, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As JET_wrn
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim data As Byte()
Dim dataSize As Integer
Dim actualDataSize As Integer
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As JET_wrn

returnValue = Api.JetRetrieveColumn(sesid, _
    tableid, columnid, data, dataSize, _
    actualDataSize, grbit, retinfo)

public static JET_wrn JetRetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    byte[] data,
    int dataSize,
    out int actualDataSize,
    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입니다.

데이터
형식: []

검색할 데이터 버퍼입니다.

dataSize
형식: System.Int32

데이터 버퍼의 크기입니다.

actualDataSize
형식: System.Int32

데이터 버퍼의 실제 크기를 반환합니다.

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

열 옵션을 검색합니다.

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

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