Metodo IVssBackupComponents::Query (vsbackup.h)

Articolo
03/08/2023

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
S_OK	È stato restituito un puntatore a un'istanza dell'interfaccia IVssEnumObject .
E_ACCESSDENIED	Il chiamante non è un amministratore o un operatore di backup.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente o altre risorse di sistema.
VSS_E_BAD_STATE	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.
VSS_E_OBJECT_NOT_FOUND	L'oggetto sottoposto a query non viene trovato.
VSS_E_PROVIDER_VETO	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.
VSS_E_UNEXPECTED	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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	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

IVssBackupComponents::InitializeForBackup

IVssBackupComponents::SetContext

IVssEnumObject