Funzione SQLSetPos

Conformità
Versione introdotta: Conformità agli standard ODBC 1.0: ODBC

Riepilogo
SQLSetPos imposta la posizione del cursore in un set di righe e consente a un'applicazione di aggiornare i dati nel set di righe o di aggiornare o eliminare dati nel set di risultati.

Sintassi

  
SQLRETURN SQLSetPos(  
      SQLHSTMT        StatementHandle,  
      SQLSETPOSIROW   RowNumber,  
      SQLUSMALLINT    Operation,  
      SQLUSMALLINT    LockType);  

Argomenti

StatementHandle
[Input] Handle di istruzione.

RowNumber
[Input] Posizione della riga nel set di righe in cui eseguire l'operazione specificata con l'argomento Operation . Se RowNumber è 0, l'operazione viene applicata a ogni riga nel set di righe.

Per altre informazioni, vedere "Commenti".

Operazione
[Input] Operazione da eseguire:

SQL_POSITION SQL_REFRESH SQL_UPDATE SQL_DELETE

Per altre informazioni, vedere "Commenti".

LockType
[Input] Specifica come bloccare la riga dopo l'esecuzione dell'operazione specificata nell'argomento Operation .

SQL_LOCK_NO_CHANGE SQL_LOCK_EXCLUSIVE SQL_LOCK_UNLOCK

Per altre informazioni, vedere "Commenti".

Valori restituiti

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_NEED_DATA, SQL_STILL_EXECUTING, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnostica

Quando SQLSetPos restituisce SQL_ERROR o SQL_SUCCESS_WITH_INFO, è possibile ottenere un valore SQLSTATE associato chiamando SQLGetDiagRec con handleType di SQL_HANDLE_STMT e handle di StatementHandle. La tabella seguente elenca i valori SQLSTATE comunemente restituiti da SQLSetPos e ne spiega ognuno nel contesto di questa funzione. La notazione "(DM)" precede le descrizioni di SQLSTATEs restituite da Gestione driver. Il codice restituito associato a ogni valore SQLSTATE è SQL_ERROR, a meno che non sia specificato diversamente.

Per tutti gli SQLSTATEs che possono restituire SQL_SUCCESS_WITH_INFO o SQL_ERROR (ad eccezione di 01xxx SQLSTATEs), SQL_SUCCESS_WITH_INFO viene restituito se si verifica un errore in una o più righe, ma non tutte, righe di un'operazione multirow e SQL_ERROR viene restituito se si verifica un errore in un'operazione a riga singola.

Commenti

Argomento RowNumber

L'argomento RowNumber specifica il numero della riga nel set di righe in cui eseguire l'operazione specificata dall'argomento Operation . Se RowNumber è 0, l'operazione viene applicata a ogni riga nel set di righe. RowNumber deve essere un valore compreso tra 0 e il numero di righe nel set di righe.

Tutte le operazioni posizionano il cursore sulla riga specificata da RowNumber. Le operazioni seguenti richiedono una posizione del cursore:

• Istruzioni di aggiornamento ed eliminazione posizionate.

• Chiamate a SQLGetData.

• Chiamate a SQLSetPos con le opzioni di SQL_DELETE, SQL_REFRESH e SQL_UPDATE.

Ad esempio, se RowNumber è 2 per una chiamata a SQLSetPos con un'operazione di SQL_DELETE, il cursore viene posizionato sulla seconda riga del set di righe e tale riga viene eliminata. La voce nella matrice di stato della riga di implementazione (a cui punta l'attributo dell'istruzione SQL_ATTR_ROW_STATUS_PTR) per la seconda riga viene modificata in SQL_ROW_DELETED.

Un'applicazione può specificare una posizione del cursore quando chiama SQLSetPos. In genere, chiama SQLSetPos con l'operazione SQL_POSITION o SQL_REFRESH per posizionare il cursore prima di eseguire un'istruzione di aggiornamento o eliminazione posizionata o chiamare SQLGetData.

Argomento operation

L'argomento Operation supporta le operazioni seguenti. Per determinare quali opzioni sono supportate da un'origine dati, un'applicazione chiama SQLGetInfo con il tipo di informazioni SQL_DYNAMIC_CURSOR_ATTRIBUTES1, SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1, SQL_KEYSET_CURSOR_ATTRIBUTES1 o SQL_STATIC_CURSOR_ATTRIBUTES1 (a seconda del tipo di cursore).

Argomento LockType

L'argomento LockType consente alle applicazioni di controllare la concorrenza. Nella maggior parte dei casi, le origini dati che supportano livelli di concorrenza e transazioni supporteranno solo il valore SQL_LOCK_NO_CHANGE dell'argomento LockType . L'argomento LockType viene in genere usato solo per il supporto basato su file.

L'argomento LockType specifica lo stato di blocco della riga dopo l'esecuzione di SQLSetPos . Se il driver non è in grado di bloccare la riga per eseguire l'operazione richiesta o per soddisfare l'argomento LockType , restituisce SQL_ERROR e SQLSTATE 42000 (errore di sintassi o violazione di accesso).

Anche se l'argomento LockType viene specificato per una singola istruzione, il blocco concede gli stessi privilegi a tutte le istruzioni sulla connessione. In particolare, un blocco acquisito da un'istruzione in una connessione può essere sbloccato da un'istruzione diversa nella stessa connessione.

Una riga bloccata tramite SQLSetPos rimane bloccata finché l'applicazione chiama SQLSetPos per la riga con LockType impostata su SQL_LOCK_UNLOCK oppure finché l'applicazione non chiama SQLFreeHandle per l'istruzione o SQLFreeStmt con l'opzione SQL_CLOSE. Per un driver che supporta le transazioni, una riga bloccata tramite SQLSetPos viene sbloccata quando l'applicazione chiama SQLEndTran per eseguire il commit o il rollback di una transazione nella connessione (se un cursore viene chiuso quando viene eseguito il commit o il rollback di una transazione, come indicato dal SQL_CURSOR_COMMIT_BEHAVIOR e SQL_CURSOR_ROLLBACK_BEHAVIOR tipi di informazioni restituiti da SQLGetInfo).

L'argomento LockType supporta i tipi di blocchi seguenti. Per determinare quali blocchi sono supportati da un'origine dati, un'applicazione chiama SQLGetInfo con il tipo di informazioni SQL_DYNAMIC_CURSOR_ATTRIBUTES1, SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1, SQL_KEYSET_CURSOR_ATTRIBUTES1 o SQL_STATIC_CURSOR_ATTRIBUTES1 (a seconda del tipo di cursore).

Se un driver supporta SQL_LOCK_EXCLUSIVE ma non supporta SQL_LOCK_UNLOCK, una riga bloccata rimarrà bloccata fino a quando non si verifica una delle chiamate di funzione descritte nel paragrafo precedente.

Se un driver supporta SQL_LOCK_EXCLUSIVE ma non supporta SQL_LOCK_UNLOCK, una riga bloccata rimarrà bloccata finché l'applicazione non chiama SQLFreeHandle per l'istruzione o SQLFreeStmt con l'opzione SQL_CLOSE. Se il driver supporta le transazioni e chiude il cursore al commit o al rollback della transazione, l'applicazione chiama SQLEndTran.

Per le operazioni di aggiornamento ed eliminazione in SQLSetPos, l'applicazione usa l'argomento LockType come indicato di seguito:

• Per garantire che una riga non venga modificata dopo il recupero, un'applicazione chiama SQLSetPos con Operation impostato su SQL_REFRESH e LockType impostato su SQL_LOCK_EXCLUSIVE.

• Se l'applicazione imposta LockType su SQL_LOCK_NO_CHANGE, il driver garantisce che un'operazione di aggiornamento o eliminazione abbia esito positivo solo se l'applicazione specificata SQL_CONCUR_LOCK per l'attributo dell'istruzione SQL_ATTR_CONCURRENCY.

• Se l'applicazione specifica SQL_CONCUR_ROWVER o SQL_CONCUR_VALUES per l'attributo di istruzione SQL_ATTR_CONCURRENCY, il driver confronta le versioni di riga o i valori e rifiuta l'operazione se la riga è stata modificata dopo il recupero della riga dall'applicazione.

• Se l'applicazione specifica SQL_CONCUR_READ_ONLY per l'attributo dell'istruzione SQL_ATTR_CONCURRENCY, il driver rifiuta qualsiasi operazione di aggiornamento o eliminazione.

Per altre informazioni sull'attributo dell'istruzione SQL_ATTR_CONCURRENCY, vedere SQLSetStmtAttr.

Matrice di stato e operazioni

Quando si chiama SQLSetPos vengono usati gli array di stato e operazioni seguenti:

• La matrice di stato della riga, a cui punta il campo SQL_DESC_ARRAY_STATUS_PTR nell'attributo di istruzione IRD e SQL_ATTR_ROW_STATUS_ARRAY, contiene i valori di stato per ogni riga di dati nel set di righe. Il driver imposta i valori di stato in questa matrice dopo una chiamata a SQLFetch, SQLFetchScroll, SQLBulkOperations o SQLSetPos. Questa matrice punta all'attributo dell'istruzione SQL_ATTR_ROW_STATUS_PTR.

• La matrice di operazioni di riga, a cui punta il campo SQL_DESC_ARRAY_STATUS_PTR nel ARD e l'attributo dell'istruzione SQL_ATTR_ROW_OPERATION_ARRAY, contiene un valore per ogni riga del set di righe che indica se una chiamata a SQLSetPos per un'operazione bulk viene ignorata o eseguita. Ogni elemento della matrice è impostato su SQL_ROW_PROCEED (impostazione predefinita) o SQL_ROW_IGNORE. Questa matrice fa riferimento all'attributo di istruzione SQL_ATTR_ROW_OPERATION_PTR.

Il numero di elementi nelle matrici di stato e operazioni deve essere uguale al numero di righe nel set di righe, come definito dall'attributo dell'istruzione SQL_ATTR_ROW_ARRAY_SIZE.

Per informazioni sulla matrice di stato della riga, vedere SQLFetch. Per informazioni sulla matrice di operazioni di riga, vedere "Ignorare una riga in un'operazione bulk" più avanti in questa sezione.

Uso di SQLSetPos

Prima che un'applicazione chiami SQLSetPos, deve eseguire la sequenza di passaggi seguente:

1. Se l'applicazione chiamerà SQLSetPos con Operation impostato su SQL_UPDATE, chiamare SQLBindCol (o SQLSetDescRec) per ogni colonna per specificare il tipo di dati e associare buffer per i dati e la lunghezza della colonna.

2. Se l'applicazione chiamerà SQLSetPos con Operation impostato su SQL_DELETE o SQL_UPDATE, chiamare SQLColAttribute per assicurarsi che le colonne da eliminare o aggiornare siano aggiornabili.

3. Chiamare SQLExecDirect, SQLExecute o una funzione di catalogo per creare un set di risultati.

4. Chiamare SQLFetch o SQLFetchScroll per recuperare i dati.

Per altre informazioni sull'uso di SQLSetPos, vedere Aggiornamento dei dati con SQLSetPos.

Eliminazione di dati tramite SQLSetPos

Per eliminare dati con SQLSetPos, un'applicazione chiama SQLSetPos con RowNumber impostato sul numero della riga da eliminare e Operation impostato su SQL_DELETE.

Dopo l'eliminazione dei dati, il driver modifica il valore nella matrice di stato della riga di implementazione per la riga appropriata in SQL_ROW_DELETED (o SQL_ROW_ERROR).

Aggiornamento dei dati tramite SQLSetPos

Un'applicazione può passare il valore di una colonna nel buffer di dati associato o con una o più chiamate a SQLPutData. Le colonne i cui dati vengono passati con SQLPutData sono note come colonne data-at-execution. Vengono comunemente usati per inviare dati per SQL_LONGVARBINARY e SQL_LONGVARCHAR colonne e possono essere combinate con altre colonne.

Per aggiornare i dati con SQLSetPos, un'applicazione:

1. Inserisce i valori nei buffer di dati e lunghezza/indicatore associati a SQLBindCol:

   • Per le colonne normali, l'applicazione inserisce il nuovo valore di colonna nel buffer *TargetValuePtr e la lunghezza di tale valore nel buffer *StrLen_or_IndPtr . Se la riga non deve essere aggiornata, l'applicazione inserisce SQL_ROW_IGNORE nell'elemento della riga della matrice di operazioni di riga.

   • Per le colonne data-at-execution, l'applicazione inserisce un valore definito dall'applicazione, ad esempio il numero di colonna, nel buffer *TargetValuePtr . Il valore può essere usato in un secondo momento per identificare la colonna.

     L'applicazione inserisce il risultato della macro SQL_LEN_DATA_AT_EXEC(lunghezza) nel buffer *StrLen_or_IndPtr . Se il tipo di dati SQL della colonna è SQL_LONGVARBINARY, SQL_LONGVARCHAR o un tipo di dati specifico dell'origine dati long e il driver restituisce "Y" per il tipo di informazioni SQL_NEED_LONG_DATA_LEN in SQLGetInfo, la lunghezza è il numero di byte di dati da inviare per il parametro; in caso contrario, deve essere un valore non negativo e viene ignorato.

2. Chiama SQLSetPos con l'argomento Operation impostato su SQL_UPDATE per aggiornare la riga di dati.

   • Se non sono presenti colonne di dati in fase di esecuzione, il processo viene completato.

   • Se sono presenti colonne data-at-execution, la funzione restituisce SQL_NEED_DATA e procede al passaggio 3.

3. Chiama SQLParamData per recuperare l'indirizzo del buffer *TargetValuePtr per la prima colonna data-at-execution da elaborare. SQLParamData restituisce SQL_NEED_DATA. L'applicazione recupera il valore definito dall'applicazione dal buffer *TargetValuePtr .

   Nota

   Anche se i parametri data-at-execution sono simili alle colonne data-at-execution, il valore restituito da SQLParamData è diverso per ognuno di essi.

   Nota

   I parametri data-at-execution sono parametri in un'istruzione SQL per cui i dati verranno inviati con SQLPutData quando l'istruzione viene eseguita con SQLExecDirect o SQLExecute. Sono associati a SQLBindParameter o impostando descrittori con SQLSetDescRec. Il valore restituito da SQLParamData è un valore a 32 bit passato a SQLBindParameter nell'argomento ParameterValuePtr .

   Nota

   Le colonne data-at-execution sono colonne in un set di righe per cui i dati verranno inviati con SQLPutData quando una riga viene aggiornata con SQLSetPos. Sono associati a SQLBindCol. Il valore restituito da SQLParamData è l'indirizzo della riga nel buffer *TargetValuePtr in fase di elaborazione.

4. Chiama SQLPutData una o più volte per inviare dati per la colonna. È necessaria più di una chiamata se non è possibile restituire tutti i valori di dati nel buffer *TargetValuePtr specificato in SQLPutData. Sono consentite più chiamate a SQLPutData per la stessa colonna solo quando si inviano dati C carattere a una colonna con un tipo di dati carattere, binario o specifico dell'origine dati o quando si inviano dati C binari a una colonna con un carattere, tipo di dati binario o specifico dell'origine dati.

5. Chiama di nuovo SQLParamData per segnalare che tutti i dati sono stati inviati per la colonna.

   • Se sono presenti più colonne data-at-execution, SQLParamData restituisce SQL_NEED_DATA e l'indirizzo del buffer TargetValuePtr per l'elaborazione della colonna data-at-execution successiva. L'applicazione ripete i passaggi 4 e 5.

   • Se non sono presenti altre colonne di dati in fase di esecuzione, il processo viene completato. Se l'istruzione è stata eseguita correttamente, SQLParamData restituisce SQL_SUCCESS o SQL_SUCCESS_WITH_INFO; se l'esecuzione non è riuscita, restituisce SQL_ERROR. A questo punto, SQLParamData può restituire qualsiasi SQLSTATE che può essere restituito da SQLSetPos.

Se i dati sono stati aggiornati, il driver modifica il valore nella matrice di stato della riga di implementazione affinché la riga appropriata venga SQL_ROW_UPDATED.

Se l'operazione viene annullata o si verifica un errore in SQLParamData o SQLPutData, dopo che SQLSetPos restituisce SQL_NEED_DATA e prima dell'invio dei dati per tutte le colonne di dati in fase di esecuzione, l'applicazione può chiamare solo SQLCancel, SQLGetDiagField, SQLGetDiagRec, SQLGetFunctions, SQLParamData o SQLPutData per l'istruzione o la connessione associata all'istruzione. Se chiama qualsiasi altra funzione per l'istruzione o la connessione associata all'istruzione , la funzione restituisce SQL_ERROR e SQLSTATE HY010 (errore della sequenza di funzioni).

Se l'applicazione chiama SQLCancel mentre il driver necessita ancora di dati per le colonne data-at-execution, il driver annulla l'operazione. L'applicazione può quindi chiamare di nuovo SQLSetPos . L'annullamento non influisce sullo stato del cursore o sulla posizione corrente del cursore.

Quando l'elenco SELECT della specifica di query associata al cursore contiene più riferimenti alla stessa colonna, se viene generato un errore o se il driver ignora i riferimenti duplicati ed esegue le operazioni richieste è definito dal driver.

Esecuzione di operazioni bulk

Se l'argomento RowNumber è 0, il driver esegue l'operazione specificata nell'argomento Operation per ogni riga del set di righe con valore SQL_ROW_PROCEED nel relativo campo nella matrice di operazioni di riga a cui punta SQL_ATTR_ROW_OPERATION_PTR attributo di istruzione. Valore valido dell'argomento RowNumber per un argomento Operation di SQL_DELETE, SQL_REFRESH o SQL_UPDATE, ma non SQL_POSITION. SQLSetPos con un'operazione di SQL_POSITION e un valore RowNumber uguale a 0 restituirà SQLSTATE HY109 (posizione del cursore non valida).

Se si verifica un errore relativo all'intero set di righe, ad esempio SQLSTATE HYT00 (timeout scaduto), il driver restituisce SQL_ERROR e l'istanza di SQLSTATE appropriata. Il contenuto dei buffer del set di righe non è definito e la posizione del cursore rimane invariata.

Se si verifica un errore relativo a una singola riga, il driver:

• Imposta l'elemento per la riga nella matrice di stato della riga a cui punta l'attributo dell'istruzione SQL_ATTR_ROW_STATUS_PTR su SQL_ROW_ERROR.

• Inserisce uno o più SQLSTATEs aggiuntivi per l'errore nella coda degli errori e imposta il campo SQL_DIAG_ROW_NUMBER nella struttura dei dati di diagnostica.

Dopo aver elaborato l'errore o l'avviso, se il driver completa l'operazione per le righe rimanenti nel set di righe, restituisce SQL_SUCCESS_WITH_INFO. Pertanto, per ogni riga che ha restituito un errore, la coda di errori contiene zero o più STATI SQL aggiuntivi. Se il driver arresta l'operazione dopo l'elaborazione dell'errore o dell'avviso, restituisce SQL_ERROR.

Se il driver restituisce avvisi, ad esempio SQLSTATE 01004 (dati troncati), restituisce avvisi che si applicano all'intero set di righe o a righe sconosciute nel set di righe prima di restituire le informazioni sull'errore applicabili a righe specifiche. Restituisce avvisi per righe specifiche insieme a eventuali altre informazioni sull'errore relative a tali righe.

Se RowNumber è uguale a 0 e Operation è SQL_UPDATE, SQL_REFRESH o SQL_DELETE, il numero di righe su cui opera SQLSetPos viene puntato dall'attributo dell'istruzione SQL_ATTR_ROWS_FETCHED_PTR.

Se RowNumber è uguale a 0 e Operation è SQL_DELETE, SQL_REFRESH o SQL_UPDATE, la riga corrente dopo l'operazione è uguale alla riga corrente prima dell'operazione.

Ignorare una riga in un'operazione bulk

La matrice di operazioni di riga può essere utilizzata per indicare che una riga nel set di righe corrente deve essere ignorata durante un'operazione bulk tramite SQLSetPos. Per indirizzare il driver a ignorare una o più righe durante un'operazione bulk, un'applicazione deve seguire questa procedura:

1. Chiamare SQLSetStmtAttr per impostare l'attributo dell'istruzione SQL_ATTR_ROW_OPERATION_PTR in modo che punti a una matrice di SQLUSMALLINTs. Questo campo può anche essere impostato chiamando SQLSetDescField per impostare il campo intestazione SQL_DESC_ARRAY_STATUS_PTR del ARD, che richiede che un'applicazione ottenga l'handle del descrittore.

2. Impostare ogni elemento della matrice di operazioni di riga su uno dei due valori seguenti:

   • SQL_ROW_IGNORE, per indicare che la riga è esclusa per l'operazione bulk.

   • SQL_ROW_PROCEED, per indicare che la riga è inclusa nell'operazione bulk. Si tratta del valore predefinito.

3. Chiamare SQLSetPos per eseguire l'operazione bulk.

Le regole seguenti si applicano alla matrice di operazioni di riga:

• SQL_ROW_IGNORE e SQL_ROW_PROCEED influiscono solo sulle operazioni bulk usando SQLSetPos con un'operazione di SQL_DELETE o SQL_UPDATE. Non influiscono sulle chiamate a SQLSetPos con un'operazione di SQL_REFRESH o SQL_POSITION.

• Il puntatore è impostato su Null per impostazione predefinita.

• Se il puntatore è Null, tutte le righe vengono aggiornate come se tutti gli elementi fossero impostati su SQL_ROW_PROCEED.

• L'impostazione di un elemento su SQL_ROW_PROCEED non garantisce che l'operazione venga eseguita in tale riga specifica. Ad esempio, se una determinata riga nel set di righe ha lo stato SQL_ROW_ERROR, il driver potrebbe non essere in grado di aggiornare tale riga indipendentemente dal fatto che l'applicazione specificata SQL_ROW_PROCEED. Un'applicazione deve sempre controllare la matrice di stato della riga per verificare se l'operazione ha avuto esito positivo.

• SQL_ROW_PROCEED è definito come 0 nel file di intestazione. Un'applicazione può inizializzare la matrice di operazioni di riga su 0 per elaborare tutte le righe.

• Se il numero di elemento "n" nella matrice di operazioni di riga è impostato su SQL_ROW_IGNORE e SQLSetPos viene chiamato per eseguire un'operazione di aggiornamento o eliminazione bulk, la na riga nel set di righe rimane invariata dopo la chiamata a SQLSetPos.

• Un'applicazione deve impostare automaticamente una colonna di sola lettura su SQL_ROW_IGNORE.

Ignorare una colonna in un'operazione bulk

Per evitare l'elaborazione non necessaria della diagnostica generata dai tentativi di aggiornamento a una o più colonne di sola lettura, un'applicazione può impostare il valore nel buffer di lunghezza/indicatore associato su SQL_COLUMN_IGNORE. Per altre informazioni, vedere SQLBindCol.

Esempio di codice

Nell'esempio seguente un'applicazione consente a un utente di esplorare la tabella ORDERS e aggiornare lo stato dell'ordine. Il cursore è basato su keyset con dimensioni del set di righe pari a 20 e usa il controllo della concorrenza ottimistica confrontando le versioni delle righe. Dopo il recupero di ogni set di righe, l'applicazione lo stampa e consente all'utente di selezionare e aggiornare lo stato di un ordine. L'applicazione usa SQLSetPos per posizionare il cursore sulla riga selezionata ed esegue un aggiornamento posizionato della riga. La gestione degli errori viene omessa per maggiore chiarezza.

#define ROWS 20  
#define STATUS_LEN 6  
  
SQLCHAR        szStatus[ROWS][STATUS_LEN], szReply[3];  
SQLINTEGER     cbStatus[ROWS], cbOrderID;  
SQLUSMALLINT   rgfRowStatus[ROWS];  
SQLUINTEGER    sOrderID, crow = ROWS, irow;  
SQLHSTMT       hstmtS, hstmtU;  
  
SQLSetStmtAttr(hstmtS, SQL_ATTR_CONCURRENCY, (SQLPOINTER) SQL_CONCUR_ROWVER, 0);  
SQLSetStmtAttr(hstmtS, SQL_ATTR_CURSOR_TYPE, (SQLPOINTER) SQL_CURSOR_KEYSET_DRIVEN, 0);  
SQLSetStmtAttr(hstmtS, SQL_ATTR_ROW_ARRAY_SIZE, (SQLPOINTER) ROWS, 0);  
SQLSetStmtAttr(hstmtS, SQL_ATTR_ROW_STATUS_PTR, (SQLPOINTER) rgfRowStatus, 0);  
SQLSetCursorName(hstmtS, "C1", SQL_NTS);  
SQLExecDirect(hstmtS, "SELECT ORDERID, STATUS FROM ORDERS ", SQL_NTS);  
  
SQLBindCol(hstmtS, 1, SQL_C_ULONG, &sOrderID, 0, &cbOrderID);  
SQLBindCol(hstmtS, 2, SQL_C_CHAR, szStatus, STATUS_LEN, &cbStatus);  
  
while ((retcode == SQLFetchScroll(hstmtS, SQL_FETCH_NEXT, 0)) != SQL_ERROR) {  
   if (retcode == SQL_NO_DATA_FOUND)  
      break;  
   for (irow = 0; irow < crow; irow++) {  
      if (rgfRowStatus[irow] != SQL_ROW_DELETED)  
         printf("%2d %5d %*s\n", irow+1, sOrderID, NAME_LEN-1, szStatus[irow]);  
   }  
   while (TRUE) {  
      printf("\nRow number to update?");  
      gets_s(szReply, 3);  
      irow = atoi(szReply);  
      if (irow > 0 && irow <= crow) {  
         printf("\nNew status?");  
         gets_s(szStatus[irow-1], (ROWS * STATUS_LEN));  
         SQLSetPos(hstmtS, irow, SQL_POSITION, SQL_LOCK_NO_CHANGE);  
         SQLPrepare(hstmtU,  
          "UPDATE ORDERS SET STATUS=? WHERE CURRENT OF C1", SQL_NTS);  
         SQLBindParameter(hstmtU, 1, SQL_PARAM_INPUT,  
            SQL_C_CHAR, SQL_CHAR,  
            STATUS_LEN, 0, szStatus[irow], 0, NULL);  
         SQLExecute(hstmtU);  
      } else if (irow == 0) {  
         break;  
      }  
   }  
}  

Per altri esempi, vedere Istruzioni di aggiornamento ed eliminazione posizionate e aggiornamento di righe nel set di righe con SQLSetPos.

Funzioni correlate

Vedi anche

Riferimento API ODBC
File di intestazione ODBC