다음을 통해 공유


CRecordset::GetBookmark

현재 레코드의 책갈피 값을 얻습니다.

void GetBookmark( 
   CDBVariant& varBookmark  
);

매개 변수

  • varBookmark
    참조 하는 CDBVariant 현재 레코드의 책갈피를 나타내는 개체입니다.

설명

레코드 집합에서 책갈피가 지원 되는지 확인 하려면 호출 CanBookmark.책갈피는 지원 되는 경우에 사용할 수 있도록 설정 해야 합니다의 CRecordset::useBookmarks 옵션에 dwOptions 매개 변수는 열려 멤버 함수.

[!참고]

책갈피 지원 되지 않거나 사용할 수 없는 경우 호출 GetBookmark 예외가 throw 됩니다.앞 으로만 이동 가능한 레코드 집합에 책갈피를 지원 하지 않습니다.

GetBookmark책갈피는 현재 레코드에 대 한 값을 할당 한 CDBVariant 개체입니다.다른 레코드로 이동한 후 언제 든 지 해당 레코드로 돌아가려면 호출 SetBookmark 에 해당 하는 CDBVariant 개체입니다.

[!참고]

특정 레코드 집합 작업 후 책갈피 더 이상 유효 하지 않을 수 없습니다.예를 들어, 호출 하는 경우 GetBookmarkRequery를 포함 하는 레코드를 반환 하지 못할 수 있습니다 SetBookmark.호출 CDatabase::GetBookmarkPersistence 안전 하 게 호출할 수 있는지 여부를 확인 하려면 SetBookmark.

책갈피 및 레코드 집합 탐색에 대 한 자세한 내용은 문서를 참조 하십시오. 레코드 집합: 책갈피와 절대 위치 (ODBC)레코드 집합: 스크롤 (ODBC).

예외

이 메서드가 형식의 예외를 throw 할 수 있습니다 CDBException *CMemoryException*.

요구 사항

헤더: afxdb.h

참고 항목

참조

CRecordset 클래스

계층 구조 차트

CRecordset::CanBookmark

CRecordset::SetBookmark

CDatabase::GetBookmarkPersistence