Metodo IVssBackupComponents::Query (vsbackup.h)
Il metodo Query esegue query sui provider nel sistema e/o sulle copie shadow completate nel sistema che risiedono nel contesto corrente. Il metodo può essere chiamato solo durante le operazioni di backup.
Sintassi
HRESULT Query(
[in] VSS_ID QueriedObjectId,
[in] VSS_OBJECT_TYPE eQueriedObjectType,
[in] VSS_OBJECT_TYPE eReturnedObjectsType,
[out] IVssEnumObject **ppEnum
);
Parametri
[in] QueriedObjectId
Riservato. Il valore di questo parametro deve essere GUID_NULL.
[in] eQueriedObjectType
Indica la restrizione della query al tipo di oggetto specificato. Un valore di VSS_OBJECT_NONE indica nessuna restrizione, ovvero tutti gli oggetti verranno sottoposti a query.
Attualmente, il valore di questo parametro deve essere VSS_OBJECT_NONE.
[in] eReturnedObjectsType
Tipi di oggetto da restituire. Il valore di questo parametro deve essere VSS_OBJECT_SNAPSHOT o VSS_OBJECT_PROVIDER.
[out] ppEnum
Puntatore indiretto doubly a un oggetto enumeratore IVssEnumObject .
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato restituito un puntatore a un'istanza dell'interfaccia IVssEnumObject . |
|
Il chiamante non è un amministratore o un operatore di backup. |
|
Uno dei valori dei parametri non è valido. |
|
Memoria insufficiente o altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato all'interno della sequenza corretta. |
|
L'oggetto sottoposto a query non viene trovato. |
|
Errore previsto del provider. Il provider ha registrato l'errore nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato. |
|
Errore imprevisto del provider. Il codice di errore viene registrato nel log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
Commenti
Poiché Query restituisce solo informazioni sulle copie shadow completate, l'unico stato di copia shadow che può divulgare è VSS_SS_COMPLETED.
Il metodo può essere chiamato solo durante le operazioni di backup e deve essere preceduto dalle chiamate a IVssBackupComponents::InitializeForBackup e IVssBackupComponents::SetContext.
Anche se Query può restituire informazioni su tutti i provider disponibili in un sistema, restituirà solo informazioni sulle copie shadow con il contesto corrente (impostato da IVssBackupComponents::SetContext). Ad esempio, se il contesto _VSS_SNAPSHOT_CONTEXT è impostato su VSS_CTX_BACKUP, query non restituirà informazioni su una copia shadow creata con un contesto di VSS_CTX_FILE_SHARE_BACKUP.
Anche se questo metodo restituisce attualmente un elenco di tutti i provider disponibili e/o di tutte le copie shadow completate, in futuro potrebbero essere supportate query specializzate: ad esempio, l'esecuzione di query su tutte le copie shadow associate a un provider.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |
Vedi anche
IVssBackupComponents::InitializeForBackup