Méthode IVssComponent::GetAlternateLocationMappingCount (vswriter.h)

La méthode GetAlternateLocationMappingCount retourne le nombre de mappages d’emplacements de remplacement utilisés par un demandeur dans la restauration des données. Un enregistreur ou un demandeur peut appeler cette méthode.

Syntaxe

HRESULT GetAlternateLocationMappingCount(
  [out] UINT *pcMappings
);

Paramètres

[out] pcMappings

Adresse d’une variable allouée par l’appelant qui reçoit le nombre de mappages d’emplacements de remplacement.

Valeur retournée

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

Valeur	Signification
S_OK	La valeur de l’attribut a été retournée.
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.

Remarques

Le nombre de mappages d’emplacements alternatifs retournés par GetAlternateLocationMappingCount peut être dû non seulement aux fichiers du composant actuel, mais aussi aux fichiers de l’un de ses sous-composants non sélectionnables.

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.

Le nombre retourné par GetAlternateLocationMappingCount fait référence au nombre de mappages d’emplacements alternatifs utilisés lors de la restauration des fichiers.

Le nombre est mis à jour par les appels à IVssBackupComponents::AddAlternativeLocationMapping.

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	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Voir aussi

IVssComponent

IVssComponent::GetAlternateLocationMapping