Méthode IVssExamineWriterMetadata::GetAlternateLocationMapping (vsbackup.h)

Article
08/27/2023

La méthode GetAlternateLocationMapping obtient un mappage d’emplacement de remplacement spécifique d’un jeu de fichiers.

Syntaxe

HRESULT GetAlternateLocationMapping(
  [in]  UINT           iMapping,
  [out] IVssWMFiledesc **ppFiledesc
);

Paramètres

[in] iMapping

Index d’un mappage particulier. La valeur de ce paramètre est un entier compris entre 0 et n–1, où n est le nombre total de mappages d’emplacements alternatifs associés à un enregistreur donné. La valeur n est retournée par IVssExamineWriterMetadata::GetRestoreMethod.

[out] ppFiledesc

Pointeur doublement indirect vers un objet IVssWMFiledesc contenant les informations de mappage d’emplacement de remplacement.

Valeur retournée

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

Valeur	Signification
S_OK	Retour réussi d’un pointeur vers une interface IVssWMFiledesc .
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT	Le document XML n’est pas valide. Consultez le journal des événements pour plus d’informations. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_OBJECT_NOT_FOUND	Le mappage d’emplacement de remplacement 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

La valeur retournée par IVssExamineWriterMetadata::GetAlternateLocationMapping ne doit pas être confondue avec celle retournée par IVssComponent::GetAlternateLocationMapping.

IVssComponent::GetAlternateLocationMapping est l’autre emplacement dans lequel un fichier a été restauré.

IVssExamineWriterMetadata::GetAlternateLocationMapping est l’autre mappage d’emplacement dans lequel un fichier peut être restauré si nécessaire.

Un fichier doit toujours être restauré dans son autre mappage d’emplacement si l’une des conditions suivantes est vraie :

La méthode de restauration (définie au moment de la sauvegarde) est VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
Sa cible de restauration a été définie (au moment de la restauration) sur VSS_RT_ALTERNATE.

Dans les deux cas, si aucun mappage d’emplacement de remplacement valide n’est défini, cela constitue une erreur d’enregistreur.

Un fichier peut être restauré dans un autre mappage d’emplacement si l’une des conditions suivantes est vraie :

La méthode de restauration est VSS_RME_RESTORE_IF_NOT_THERE et une version du fichier est déjà présente sur le disque.
La méthode de restauration est VSS_RME_RESTORE_IF_CAN_REPLACE et une version du fichier est présente sur le disque et ne peut pas être remplacée.

Là encore, si aucun mappage d’emplacement alternatif valide n’est défini, cela constitue une erreur de rédacteur.

Un mappage d’emplacement de remplacement est utilisé uniquement pendant une opération de restauration et ne doit pas être confondu avec un autre chemin, qui est utilisé uniquement pendant une opération de sauvegarde.

L’appelant est responsable de l’appel de IUnknown::Release pour libérer les ressources de l’objet IVssWMFiledesc retourné.

Configuration requise


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