Méthode IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths (vsbackup.h)
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 |
|---|---|
|
Les informations de chemin d’accès ont été retournées. |
|
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) |