Méthode IVssBackupComponents ::Query (vsbackup.h)

Article
08/27/2023

La méthode Query interroge les fournisseurs sur le système et/ou les clichés instantanés terminés dans le système qui résident dans le contexte actuel. La méthode peut être appelée uniquement pendant les opérations de sauvegarde.

Syntaxe

HRESULT Query(
  [in]  VSS_ID          QueriedObjectId,
  [in]  VSS_OBJECT_TYPE eQueriedObjectType,
  [in]  VSS_OBJECT_TYPE eReturnedObjectsType,
  [out] IVssEnumObject  **ppEnum
);

Paramètres

[in] QueriedObjectId

Réservé. La valeur de ce paramètre doit être GUID_NULL.

[in] eQueriedObjectType

Indique la restriction de la requête au type d’objet donné. La valeur VSS_OBJECT_NONE indique aucune restriction, c’est-à-dire que tous les objets seront interrogés.

Actuellement, la valeur de ce paramètre doit être VSS_OBJECT_NONE.

[in] eReturnedObjectsType

Types d’objets à retourner. La valeur de ce paramètre doit être VSS_OBJECT_SNAPSHOT ou VSS_OBJECT_PROVIDER.

[out] ppEnum

Pointeur doublement indirect vers un objet énumérateur IVssEnumObject .

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur	Signification
S_OK	Retour réussi d’un pointeur vers un instance de l’interface IVssEnumObject.
E_ACCESSDENIED	L’appelant n’est pas un administrateur ou un opérateur de sauvegarde.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	Mémoire insuffisante ou autres ressources système.
VSS_E_BAD_STATE	L’objet de composants de sauvegarde n’est pas initialisé, cette méthode a été appelée pendant une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte.
VSS_E_OBJECT_NOT_FOUND	L’objet interrogé est introuvable.
VSS_E_PROVIDER_VETO	Erreur du fournisseur attendue. Le fournisseur a enregistré l’erreur dans le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_UNEXPECTED	Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Erreur de fournisseur inattendue. Le code d’erreur est journalisé dans le journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Remarques

Étant donné que query retourne uniquement des informations sur les clichés instantanés terminés, le seul état de cliché instantané qu’il peut divulguer est VSS_SS_COMPLETED.

La méthode peut être appelée uniquement pendant les opérations de sauvegarde et doit être précédée d’appels à IVssBackupComponents ::InitializeForBackup et IVssBackupComponents ::SetContext.

Bien que query puisse retourner des informations sur tous les fournisseurs disponibles sur un système, elle retourne uniquement des informations sur les clichés instantanés avec le contexte actuel (défini par IVssBackupComponents ::SetContext). Par instance, si le contexte _VSS_SNAPSHOT_CONTEXT est défini sur VSS_CTX_BACKUP, la requête ne retourne pas d’informations sur un cliché instantané créé avec un contexte de VSS_CTX_FILE_SHARE_BACKUP.

Bien que cette méthode retourne actuellement une liste de tous les fournisseurs disponibles et/ou de tous les clichés instantanés terminés, à l’avenir, les requêtes spécialisées peuvent être prises en charge : pour instance, l’interrogation de tous les clichés instantanés associés à un fournisseur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Voir aussi

IVssBackupComponents

IVssBackupComponents ::InitializeForBackup

IVssBackupComponents ::SetContext

IVssEnumObject