dsmGetNextQObj

Modifica in linea

La chiamata alla funzione dsmGetNextQObj ottiene la risposta della query successiva da una chiamata dsmBeginQuery precedente e inserisce la risposta nel buffer del chiamante.

La chiamata dsmGetNextQObj viene richiamata una o più volte. Ogni volta che la funzione viene richiamata, viene richiamato un singolo record di query oppure viene restituito un errore o un codice di errore DSM_RC_FINISHED . Se viene restituito DSM_RC_FINISHED , non ci sono più dati da elaborare. Quando vengono richiamati tutti i dati della query o se non sono necessari ulteriori dati della query, inviare la chiamata dsmEndQuery per terminare l'elaborazione della query.

Il parametro dataBlkPtr deve puntare a un buffer definito con il tipo di struttura qryResp*Data . Il contesto in cui viene chiamato dsmGetNextQObj determina il tipo di struttura immesso nella risposta della query.

Sintassi

dsInt16_t dsmGetNextQObj (dsUint32_t   dsmHandle,
   DataBlk *dataBlkPtr);

Parametri

dsmHandledsUint32_t (I)

L'handle che associa questa chiamata a una precedente chiamata dsmInitEx .

*dataBlkPtrDataBlk (I/O)

Indica una struttura che include sia un puntatore al buffer per i dati da ricevere che la dimensione del buffer. Questo buffer è la struttura di risposta qryResp*Data . Alla restituzione, questa struttura contiene il numero di byte trasferiti. La struttura associata a ogni tipo di query è descritta nella seguente tabella. Per ulteriori informazioni sulla definizione del tipo di DataBlk, consultare il seguente argomento: File di origine delle definizioni del tipo API.

Tabella 1. DataBlk
Interroga	Struttura della risposta	Settori di particolare interesse
qtArchive	qryRespArchiveData	sizeEstimate Contiene il valore passato su una chiamata dsmSendObj precedente. mediaClass Può avere il valore `MEDIA_FIXED` se l'oggetto si trova su disco o `MEDIA_LIBRARY` se l'oggetto si trova su nastro. clientDeduplicated Indica se questo oggetto è deduplicato dal client.
qtBackup	qryRespBackupData	restoreOrderExt È di tipo `dsUint16_t`. Ordina in base a questo campo quando più oggetti vengono ripristinati in una chiamata dsmBeginGetData . Un esempio di codice di ordinamento per questa chiamata è nell'esempio API, `dapiqry.c`. Per un esempio di ordinamento, consultare il seguente argomento: Figura 1. sizeEstimate Contiene il valore passato su una chiamata dsmSendObj precedente. mediaClass Può avere il valore `MEDIA_FIXED` se l'oggetto si trova su disco o `MEDIA_LIBRARY` se l'oggetto si trova su nastro. clientDeduplicated Indica se questo oggetto è deduplicato dal client.
qtBackupActive	qryARespBackupData
qtBackupGroups	qryRespBackupData	dsBool_t isGroupLeader Se true, indica che questo oggetto è un leader del gruppo.
qtOpenGroups	qryRespBackupData	dsBool_t isOpenGroup; Se true, indica che questo gruppo è aperto e non completo.
qtFilespace	qryRespFSData	backStartDate Contiene la data / ora del server quando lo spazio file viene aggiornato con l'azione backStartDate . backCompleteDate Contiene la data / ora del server quando lo spazio file viene aggiornato con l'azione backCompleteDate . lastReplStartDate Contiene la data e l'ora dell'ultima volta in cui è stata avviata la replica sul server. lastReplCmpltDate Contiene la data e l'ora dell'ultima volta in cui è stata completata la replica, anche se si è verificato un errore. lastBackOpDateFromServer Contiene la data / ora dell'ultimo negozio salvato sul server. lastBackOpDateFromLocal Contiene l'ultima data/ora del negozio salvata sul client.
qtMC	qryRespMCData qryRespMCDetailData
qtProxyNodeAuth	qryRespProxyNodeData targetNodeName peerNodeName hlAddress llAddress
qtProxyNodePeer	qryRespProaxyNodeData targetNodeName peerNodeName hlAddress llAddress

Codici di ritorno

La seguente tabella descrive i codici di ritorno per la chiamata della funzione dsmGetNextQObj .

Tabella 2. Codici di ritorno per la dsmGetNextQObj chiamata di funzione
Codice di ritorno	Numero codice di ritorno	Descrizione
`DSM_RC_ABORT_NO_MATCH`	2	Non è stata richiesta alcuna corrispondenza per la query.
`DSM_RC_FINISHED`	121	Elaborazione terminata (avviare dsmEndQuery). Non ci sono più dati da elaborare.
`DSM_RC_UNKNOWN_FORMAT`	122	Il file che IBM® Storage Protect ha tentato di ripristinare o richiamare ha un formato sconosciuto.
`DSM_RC_COMM_PROTOCOL_ERROR`	136	Errore del protocollo di comunicazione.
`DSM_RC_NULL_DATABLKPTR`	2001	Il puntatore non punta ad un blocco dati.
`DSM_RC_INVALID_MCNAME`	2025	Nome classe di gestione non valido.
`DSM_RC_BAD_CALL_SEQUENCE`	2041	La sequenza di chiamate non è valida.
`DSM_RC_WRONG_VERSION_PARM`	2065	La versione dell'API del client applicativo è differente dalla versione di libreria IBM Storage Protect .
`DSM_RC_MORE_DATA`	2200	Ci sono più dati da ottenere.
`DSM_RC_BUFF_TOO_SMALL`	2210	Il buffer è troppo piccolo.