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

Article
03/03/2024

La méthode GetWriterComponents est utilisée pour retourner des informations sur les composants d’un enregistreur donné qui ont été stockés dans le document des composants de sauvegarde d’un demandeur.

Syntaxe

HRESULT GetWriterComponents(
  [in]  UINT                    iWriter,
  [out] IVssWriterComponentsExt **ppWriter
);

Paramètres

[in] iWriter

Index du writer interrogé. Il s’agit d’un nombre compris entre 0 et n-1, où n est la valeur retournée par IVssBackupComponents ::GetWriterComponentsCount.

[out] ppWriter

Pointeur doublement indirect vers un objet d’interface IVssWriterComponentsExt qui recevra les informations de composant retournées.

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 objet d’interface IVssWriterComponentsExt .
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a plus de mémoire ou d’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	Le cliché instantané spécifié n’existe pas.
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.

Remarques

L’appelant de cette méthode doit appeler IUnknown ::Release lorsqu’il a terminé d’accéder aux informations du composant.

GetWriterComponents récupère les informations sur les composants d’un composant stocké dans le document composants de sauvegarde en appelant précédemment IVssBackupComponents ::AddComponent.

Les informations contenues dans les composants stockés dans le document Composants de sauvegarde ne sont pas statiques. Si un writer met à jour un composant pendant une restauration, cette modification est répercutée dans le composant récupéré par GetWriterComponents. Cela contraste avec les informations de composant trouvées dans l’objet IVssWMComponent retourné par IVssExamineWriterMetadata ::GetComponent. Ces informations sont en lecture seule et proviennent du document de métadonnées writer d’un processus writer.

Le pointeur d’interface IVssWriterComponentsExt retourné dans le paramètre pWriterComponents ne doit pas être mis en cache, car les méthodes IVssBackupComponents suivantes entraînent la non-validité du pointeur d’interface retourné par GetWriterComponents :

IVssBackupComponents ::P repareForBackup IVssBackupComponents ::D oSnapshotSet IVssBackupComponents ::BackupComplete IVssBackupComponents ::P restore IVssBackupComponents ::P ostRestore Si vous appelez l’une de ces méthodes après avoir récupéré un pointeur d’interface IVssWriterComponentsExt en appelant GetWriterComponents, vous ne pouvez pas réutiliser ce pointeur, parce qu’il n’est plus valide. Au lieu de cela, vous devez appeler à nouveau GetWriterComponents pour récupérer un nouveau pointeur d’interface IVssWriterComponentsExt .

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