Méthode IVssWMDependency ::GetLogicalPath (vswriter.h)
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 |
|---|---|
|
Le chemin d’accès logique du composant dont dépend le composant actuel a été correctement retourné. |
|
Aucun writer ne peut être trouvé qui gère le composant dont dépend le composant actuel. |
|
Le pointeur pbstrLogicalPath pointe vers la mémoire non allouée. |
|
L’appelant n’a plus de mémoire ou d’autres ressources système. |
|
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. |
|
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