IVssWriterComponents::GetComponent-Methode (vswriter.h)

  • Artikel

Die GetComponent-Methode gibt eine IVssComponent-Schnittstelle für eine der Komponenten eines bestimmten Writers zurück, die explizit im Dokument Sicherungskomponenten gespeichert sind.

Syntax

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

Parameter

[in] iComponent

Anzahl der Komponente. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtanzahl der von IVssWriterComponents::GetComponentCount zurückgegebenen Komponenten ist.

[out] ppComponent

Doppelt indirekter Zeiger auf eine instance des IVssComponent-Objekts, das Komponenteninformationen enthält.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert Bedeutung
S_OK
 Die Komponente wurde erfolgreich zurückgegeben.
E_INVALIDARG
 Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
 Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_OBJECT_NOT_FOUND
 Die angegebene Komponente wurde nicht gefunden.

Hinweise

Der Aufrufer ist für den Aufruf von IUnknown::Release verantwortlich, um Systemressourcen freizugeben, die vom zurückgegebenen IVssComponent-Objekt gespeichert sind.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (einschließlich Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssWriterComponents