Méthode IVssWriterComponents::GetComponent (vswriter.h)

Article
08/27/2023

La méthode GetComponent renvoie une interface IVssComponent à l’un des composants d’un writer donné explicitement stockés dans le document Composants de sauvegarde.

Syntaxe

HRESULT GetComponent(
  [in]  UINT          iComponent,
  [out] IVssComponent **ppComponent
);

Paramètres

[in] iComponent

Numéro du composant. La valeur de ce paramètre est un entier compris entre 0 et n–1 inclus, où n est le nombre total de composants retournés par IVssWriterComponents::GetComponentCount.

[out] ppComponent

Pointeur doublement indirect vers un instance de l’objet IVssComponent qui contient des informations sur les composants.

Valeur retournée

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

Valeur	Signification
S_OK	Le composant a été retourné.
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_OBJECT_NOT_FOUND	Le composant spécifié est introuvable.

Remarques

L’appelant est chargé d’appeler IUnknown::Release pour libérer les ressources système détenues par l’objet IVssComponent retourné.

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

IVssWriterComponents

Partager via