Méthode IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths (vsbackup.h)

  • Article

Normalise un chemin d’accès de volume local ou un chemin de partage UNC afin qu’il puisse être transmis à la méthode IVssBackupComponents::AddToSnapshotSet .

Syntaxe

HRESULT GetRootAndLogicalPrefixPaths(
  [in]           VSS_PWSZ pwszFilePath,
  [out]          VSS_PWSZ *ppwszRootPath,
  [out]          VSS_PWSZ *ppwszLogicalPrefix,
  [in, optional] BOOL     bNormalizeFQDNforRootPath
);

Paramètres

[in] pwszFilePath

Chemin à normaliser.

[out] ppwszRootPath

Reçoit le chemin d’accès racine qui doit être passé à la méthode IVssBackupComponents::AddToSnapshotSet .

[out] ppwszLogicalPrefix

Si pwszFilePath est un chemin d’accès local, ce paramètre reçoit le nom du GUID de volume. S’il s’agit d’un chemin UNC, ce paramètre reçoit un chemin de partage entièrement évalué.

[in, optional] bNormalizeFQDNforRootPath

Si pwszFilePath est un chemin de partage UNC, la partie nom du serveur peut être

  • Nom d’hôte
  • Nom de domaine complet
  • Une adresse IP

Ce paramètre spécifie si le format de nom d’hôte ou le format de nom de domaine complet doivent être utilisés dans la partie nom du serveur du chemin d’accès racine normalisé retourné dans le paramètre ppwszRootPath .

Si ce paramètre a la valeur FALSE, un format de nom d’hôte simple est utilisé.

La valeur par défaut de ce paramètre est FALSE.

Si ce paramètre a la valeur TRUE, un nom de domaine complet est utilisé.

Dans un déploiement où un nom d’hôte peut exister dans plusieurs suffixes de domaine, ce paramètre doit être TRUE.

Valeur retournée

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

Code de retour Description
S_OK
 Les informations de chemin d’accès ont été retournées.
E_OUTOFMEMORY
 L’appelant n’a pas de mémoire ou d’autres ressources système.

Remarques

Cette méthode normalise un chemin d’accès de volume local ou un chemin de partage UNC et le sépare en un chemin racine et un chemin de préfixe logique. Le chemin racine peut ensuite être passé à la méthode IVssBackupComponents::AddToSnapshotSet .

Si pwszFilePath est un chemin d’accès de volume local, le chemin d’accès racine sera similaire à un point de montage de volume. Dans ce cas, les chemins racine et de préfixe logique sont mappés aux résultats de GetVolumePathName et GetVolumeNameForVolumeMountPoint, respectivement.

Si pwszFilePath est un chemin de partage UNC, les chemins d’accès racine et de préfixe logique sont mappés au chemin racine du partage de fichiers et au chemin d’accès de partage physique entièrement évalué (qui prend en compte le déploiement de DFS et de cluster), respectivement.

Si vous appelez cette méthode plusieurs fois pour la même opération de création de jeu de cliché instantané, vous devez définir bNormalizeFQDNforRootPath sur la même valeur pour chaque appel. Le format de nom de domaine complet et le format de nom d’hôte ne peuvent pas être mélangés dans le même jeu de cliché instantané.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)

Voir aussi

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4