Partager via


Méthode IVssWMFiledesc::GetPath (vswriter.h)

La méthode GetPath obtient le chemin du répertoire complet ou le chemin UNC du partage de fichiers distant pour obtenir la liste des fichiers décrits dans l’objet IVssWMFiledesc actuel.

Une méthode d’interrogation a utilisé ce chemin d’accès et une spécification de fichier pour retourner l’objet IVssWMFiledesc actuel.

Syntaxe

HRESULT GetPath(
  [out] BSTR *pbstrPath
);

Paramètres

[out] pbstrPath

Adresse d’une variable allouée à l’appelant qui reçoit une chaîne de caractères larges terminée par NULL spécifiant le chemin d’accès complet du répertoire complet ou le chemin UNC du répertoire de partage de fichiers distant.

Le chemin d’accès peut être un nom de fichier long ou court et peut utiliser le préfixe « \? ». Pour plus d’informations, consultez Nommer un fichier.

Les utilisateurs de cette méthode doivent case activée pour déterminer si ce chemin se termine par une barre oblique inverse («  »).

Valeur retournée

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

Valeur Signification
S_OK
Les informations de chemin d’accès ont été retournées.
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_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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP et Windows Server 2003 : Les partages de fichiers distants ne sont pas pris en charge tant que Windows 8 et Windows Server 2012.

L’appelant doit appeler SysFreeString pour libérer la mémoire détenue par le paramètre pbstrPath .

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

IVssWMFiledesc