CRecordset::SetRowsetCursorPosition

發行項
02/28/2013

將游標移至目前資料列集內的資料列。

void SetRowsetCursorPosition(
   WORD wRow,
   WORD wLockType = SQL_LOCK_NO_CHANGE 
);

參數

wRow
資料列的以一起始的位置位於目前資料列集。這個值的範圍可從 1 到資料列集的大小。
wLockType
在重新整理之後，將值如何鎖定執行它。如需詳細資訊，請參閱"備註"。

備註

當實作時擷取大量資料列擷取，資料錄的資料列擷取，然後將擷取的資料列集的第一筆資料錄保留為目前資料錄。若要在資料列集內的另一個資料錄目前記錄的，呼叫 SetRowsetCursorPosition。例如，您可以結合 SetRowsetCursorPosition 與 GetFieldValue 成員函式從您的資料錄集的所有資料錄動態擷取資料。

若要使用 SetRowsetCursorPosition，您必須實作擷取傳遞指定的大量資料列 dwOptions 參數的 CRecordset::useMultiRowFetch 選取開啟成員函式。

SetRowsetCursorPosition 呼叫 ODBC API 函式 SQLSetPos。在 SQLSetPos 執行之後， wLockType 參數指定的鎖定狀態。下表說明 wLockType. 的可能值。

wLockType	描述
SQL_LOCK_NO_CHANGE (預設值)	驅動程式或資料來源可確保執行做為它是相同的鎖定或解除鎖定的狀態，在 SetRowsetCursorPosition 呼叫之前。
SQL_LOCK_EXCLUSIVE	驅動程式或資料來源獨佔鎖定的資料列。不是所有資料來源都支援這個鎖定類型。
SQL_LOCK_UNLOCK	驅動程式或資料來源上執行。不是所有資料來源都支援這個鎖定類型。