Partager via

Méthode IVssWMDependency ::GetLogicalPath (vswriter.h)

  • Article

La méthode GetLogicalPath récupère le chemin logique d’un composant dont dépend le composant actuel dans la dépendance writer-component explicite.

Syntaxe

HRESULT GetLogicalPath(
  [out] BSTR *pbstrLogicalPath
);

Paramètres

[out] pbstrLogicalPath

Adresse d’une variable allouée à l’appelant qui reçoit une chaîne de caractères larges terminée par NULL contenant le chemin logique du composant dont dépend le composant actuel.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur Signification
S_OK
 Le chemin d’accès logique du composant dont dépend le composant actuel a été correctement retourné.
S_FALSE
 Aucun writer ne peut être trouvé qui gère le composant dont dépend le composant actuel.
E_INVALIDARG
 Le pointeur pbstrLogicalPath pointe vers la mémoire non allouée.
E_OUTOFMEMORY
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT
 Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. 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

L’appelant doit libérer la mémoire utilisée par la chaîne retournée en appelant SysFreeString.

Une dépendance n’indique pas un ordre de préférence entre le composant avec les dépendances documentées et les composants dont il dépend. Une dépendance indique simplement que le composant et les composants dont il dépend doivent toujours être sauvegardés ou restaurés ensemble.

Il est possible d’avoir plusieurs instances d’une classe writer donnée ; Toutefois, le chemin logique et le nom d’un composant doivent être uniques.

S’il existe plusieurs instances d’une classe writer, il est nécessaire d’utiliser les informations de chemin logique et de nom de composant pour identifier le instance gérer le composant dont dépend le composant actuel.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [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

IVssWMComponent ::GetDependency

IVssWMDependency

IVssWMDependency ::GetComponentName

IVssWMDependency ::GetWriterId