Méthode IVssBackupComponents ::Query (vsbackup.h)
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 |
|---|---|
|
Retour réussi d’un pointeur vers un instance de l’interface IVssEnumObject. |
|
L’appelant n’est pas un administrateur ou un opérateur de sauvegarde. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
Mémoire insuffisante ou autres ressources système. |
|
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. |
|
L’objet interrogé est introuvable. |
|
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. |
|
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. |
|
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 ::InitializeForBackup