CRecordset::SetBookmark

其中包含指定的書籤的資料錄中的資料錄集。

void SetBookmark( 
   const CDBVariant& varBookmark  
);

參數

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

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

若要先將會擷取目前記錄的，呼叫 GetBookmark書籤，儲存書籤值組 CDBVariant 物件。之後，會使用已儲存的書籤值，可返回該資料錄會藉由呼叫 SetBookmark 。

注意事項
在特定資料錄集作業之後，您應該在呼叫 SetBookmark之前檢查書籤的保存性 (Persistence)。例如，在中，當您擷取與 GetBookmark 的書籤，然後呼叫 Requery書籤可能不再有效。呼叫 CDatabase::GetBookmarkPersistence 確認是否可安全地呼叫 SetBookmark。