CRecordset::GetBookmark

取得目前資料錄的書籤值。

void GetBookmark( 
   CDBVariant& varBookmark  
);

參數

判斷書籤是否在資料錄集支援，呼叫 CanBookmark。若要讓書籤可用，則支援，您必須在開啟成員函式的 dwOptions 參數的 CRecordset::useBookmarks 選項。

注意事項
如果書籤不支援或不可見的， GetBookmark 呼叫會導致擲回例外狀況。書籤在順向資料錄集並不支援。

GetBookmark 指派書籤的值目前資料錄的 CDBVariant 至物件。若要隨時返回該筆移至不同的資料錄後，請呼叫對應的 CDBVariant 物件的 SetBookmark 。

注意事項
在特定資料錄集作業之後，書籤可能不再有效。例如，如果您要 GetBookmark ，後面接著 Requery，您就無法傳回至 SetBookmark的資料錄。呼叫 CDatabase::GetBookmarkPersistence 確認是否可安全地呼叫 SetBookmark。