Partager via


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
S_OK
Nous avons retourné le nom du composant dont dépend le composant actuel.
S_FALSE
Aucun enregistreur ne peut être trouvé qui gère le composant dont dépend le composant actuel.
E_INVALIDARG
Le pointeur pbstrComponentName pointe vers la mémoire non allouée.
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

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

IVssWMDependency

IVssWMDependency ::GetLogicalPath

IVssWMDependency ::GetWriterId