Struttura JET_RETRIEVECOLUMN

  • Articolo

Si applica a: Windows | Windows Server

Struttura JET_RETRIEVECOLUMN

La struttura JET_RETRIEVECOLUMN contiene parametri di input e output per JetRetrieveColumns. I campi nella struttura descrivono il valore della colonna da recuperare, come recuperarlo e dove salvare i risultati.

    typedef struct {
      JET_COLUMNID columnid;
      void* pvData;
      unsigned long cbData;
      unsigned long cbActual;
      JET_GRBIT grbit;
      unsigned long ibLongValue;
      unsigned long itagSequence;
      JET_COLUMNID columnidNextTagged;
      JET_ERR err;
    } JET_RETRIEVECOLUMN;

Membri

columnid

Identificatore di colonna per la colonna da recuperare.

pvData

Puntatore per iniziare a archiviare i dati recuperati dal valore della colonna.

cbData

Dimensioni dell'allocazione a partire da pvData, in byte. L'operazione di recupero della colonna non archivierà più dati in pvData rispetto a cbData.

cbActual

Dimensione, in byte, di dati recuperati da un'operazione di recupero della colonna.

grbit

Gruppo di bit che contengono le opzioni per il recupero delle colonne, che includono zero o più dei valori seguenti.

Valore

Significato

JET_bitRetrieveCopy

Recupera il valore modificato anziché il valore originale. Se il valore non è stato modificato, viene recuperato il valore originale. In questo modo, è possibile recuperare un valore che non è ancora stato inserito o aggiornato quando un record viene inserito o aggiornato.

JET_bitRetrieveFromIndex

Recupera i valori di colonna dall'indice senza accedere al record, se possibile. In questo modo, il caricamento non necessario dei record può essere evitato quando i dati necessari sono disponibili dalle voci di indice stesse. Nei casi in cui il valore della colonna originale non può essere recuperato dall'indice, a causa di trasformazioni irreversibili o troncamento dei dati, verrà eseguito l'accesso al record e i dati recuperati come di consueto. Si tratta di un'opzione di prestazioni che deve essere specificata solo quando è probabile che il valore della colonna possa essere recuperato dall'indice. Questa opzione non deve essere specificata se l'indice corrente è l'indice cluster, poiché le voci di indice per il cluster o l'indice primario sono i record stessi. Questo bit non può essere impostato se è impostato anche JET_bitRetrieveFromPrimaryBookmark.

JET_bitRetrieveFromPrimaryBookmark

Recupera i valori di colonna dal segnalibro dell'indice e può essere diverso dal valore di indice quando una colonna viene visualizzata sia nell'indice primario che nell'indice corrente. Questa opzione non deve essere specificata se l'indice corrente è l'indice cluster o primario. Questo bit non può essere impostato se è impostato anche JET_bitRetrieveFromIndex.

JET_bitRetrieveTag

Recupera il numero di sequenza di un valore di colonna multivalore in pretinfo-itagSequence>. Il campo itagSequence viene spesso usato un input per recuperare i valori di colonna multivalore da un record. Tuttavia, quando si recuperano valori da un indice, è anche possibile associare la voce di indice a un determinato numero di sequenza e recuperare anche questo numero di sequenza. Il recupero del numero di sequenza può essere un'operazione costosa e deve essere eseguita solo se necessario.

JET_ bitRetrieveNull

Recupera i valori NULL della colonna multivalore. Se questa opzione non viene specificata, i valori NULL della colonna multivalore verranno ignorati automaticamente.

JET_bitRetrieveIgnoreDefault

Fa sì che venga restituito un valore NULL quando il numero di sequenza richiesto è 1 e non sono presenti valori impostati per la colonna nel record. Questa opzione influisce solo sulle colonne multivalore.

JET_bitRetrieveLongId

Questo flag è destinato solo all'uso interno e non deve essere usato nell'applicazione.

JET_bitRetrieveLongValueRefCount

Questo flag è destinato solo all'uso interno e non deve essere usato nell'applicazione.

ibLongValue

Offset al primo byte da recuperare da una colonna di tipo JET_coltypLongBinary o JET_coltypLongText.

itagSequence

Numero di sequenza dei valori contenuti in una colonna multivalore. itagSequence qui nel JET_RETRIEVECOLUMN può essere 0. Se itagSequence è 0, viene restituito il numero di istanze di una colonna multivalore anziché i dati di colonna. Non è possibile usare un valore itagSequence pari a 0 nelle chiamate a JetRetrieveColumn.

columnidNextTagged

Columnid della colonna con tag, multivalore o sparse quando tutte le colonne contrassegnate vengono recuperate passando 0 come columnid a JetRetrieveColumn.

err

Codici di errore e avvisi restituiti dal recupero della colonna.

Requisiti

Requisito Valore

Client

Richiede Windows Vista, Windows XP o Windows 2000 Professional.

Server

Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Intestazione

Dichiarato in Esent.h.

Vedere anche

JET_COLTYP
JET_COLUMNID
JET_ERR
JET_GRBIT
JET_RETRIEVECOLUMN
JetRetrieveColumn
JetRetrieveColumns