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

  • Article

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