Méthode IVssWMDependency ::GetComponentName (vswriter.h)
La méthode GetComponentName récupère le nom d’un composant dont dépend le composant actuel dans une dépendance de composant writer-component explicite.
Syntaxe
HRESULT GetComponentName(
BSTR *pbstrComponentName
);
Paramètres
pbstrComponentName
Adresse d’une variable allouée à l’appelant qui reçoit une chaîne de caractères larges terminée par null contenant le nom du composant dont dépend le composant actuel.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
Nous avons retourné le nom du composant dont dépend le composant actuel. |
|
Aucun enregistreur ne peut être trouvé qui gère le composant dont dépend le composant actuel. |
|
Le pointeur pbstrComponentName pointe vers la mémoire non allouée. |
|
L’appelant n’a pas de mémoire ou d’autres ressources système. |
|
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. |
|
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 d’ordre de préférence entre le composant avec les dépendances documentées et les composants dont elle 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 d’enregistreur donnée ; Toutefois, le chemin d’accès logique et le nom de tout composant doivent être uniques.
S’il existe plusieurs instances d’une classe writer, il est nécessaire d’utiliser les informations de chemin d’accès logique et de nom de composant pour identifier les instance de gestion du 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