Funzione JetGotoPosition

Si applica a: Windows | Windows Server

Funzione JetGotoPosition

La funzione JetGotoPosition sposta un cursore in una nuova posizione che rappresenta una frazione del percorso attraverso l'indice corrente. La frazione è approssimativamente uguale alla seguente:

precpos-centriesLT>/precpos-centriesTotal>

Questa operazione viene eseguita in risposta all'input della casella di scorrimento dell'utente ricevuta quando l'utente tenta di visualizzare i dati che iniziano in parte attraverso un set di dati.

    JET_ERR JET_API JetGotoPosition(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_RECPOS* precpos
    );

Parametri

sesid

Sessione da utilizzare per questa chiamata.

tableid

Cursore da utilizzare per questa chiamata.

precpos

Descrizione della frazione da utilizzare per posizionare il cursore nell'indice corrente.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.

Se questa funzione ha esito positivo, il cursore viene spostato in un record corrente che rappresenta una frazione del percorso nell'indice in cui la frazione è precpos-centriesLT> divisa per precpos-centriesTotal>.

Se questa funzione ha esito negativo, la posizione del cursore rimane invariata.

Commenti

Questa operazione sposta il cursore attraverso la tabella in una posizione in corrispondenza del punto approssimativo seguente: precpos-centriesLT> diviso per precpos-centriesTotal>.

Quando gli aggiornamenti si verificano continuamente nella tabella, le chiamate successive con lo stesso JET_RECPOS possono spostare il cursore in posizioni diverse nell'indice, sia prima che dopo la posizione precedente. L'isolamento transazionale non si applica al posizionamento tramite JET_RECPOS perché dipende dalle proprietà fisiche dell'indice che non sono isolate dalla transazione.

JET_RECPOS non deve essere utilizzato per descrivere un record all'interno di una tabella o per riposizionare un record vicino a un record esistente. I segnalibri per un record esistente devono invece essere recuperati dopo un oggetto JetGotoPosition iniziale e quindi usati per riposizionare lo stesso record.

Requisiti

Vedere anche

JET_COLUMNID
JET_ERR
JET_SESID
JET_TABLEID
JET_RECPOS
JET_SETINFO