Méthode IVssComponent::GetRestoreSubcomponent (vswriter.h)

Article
08/27/2023

La méthode GetRestoreSubcomponent retourne le sous-composant spécifié associé à un composant donné.

Un writer ou un demandeur peut appeler cette méthode.

Syntaxe

HRESULT GetRestoreSubcomponent(
  [in]  UINT iComponent,
  [out] BSTR *pbstrLogicalPath,
  [out] BSTR *pbstrComponentName,
  [out] bool *pbRepair
);

Paramètres

[in] iComponent

Index du sous-composant. La valeur de ce paramètre est un entier compris entre 0 et n–1 inclus, où n est le nombre total de sous-composants associés à un composant donné. La valeur n est retournée par IVssComponent::GetRestoreSubcomponentCount.

[out] pbstrLogicalPath

Pointeur vers une chaîne contenant le chemin logique du sous-composant. Le chemin logique ne peut pas être vide lors de l’utilisation de sous-composants.

[out] pbstrComponentName

Pointeur vers une chaîne contenant le nom du sous-composant. La chaîne ne peut pas être vide.

[out] pbRepair

Réservé pour un usage futur.

Valeur retournée

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

Valeur	Signification
S_OK	La valeur de l’attribut a été retournée.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
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_OBJECT_NOT_FOUND	L’élément spécifié est introuvable.

Remarques

L’appelant doit libérer la mémoire détenue par les paramètres pbstrLogicalPath et pbstrComponentName en appelant SysFreeString.

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

IVssComponent

Partager via