IVssComponent::GetRestoreSubcomponent-Methode (vswriter.h)
Die GetRestoreSubcomponent-Methode gibt die angegebene Teilkomponente zurück, die einer bestimmten Komponente zugeordnet ist.
Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.
Syntax
HRESULT GetRestoreSubcomponent(
[in] UINT iComponent,
[out] BSTR *pbstrLogicalPath,
[out] BSTR *pbstrComponentName,
[out] bool *pbRepair
);
Parameter
[in] iComponent
Index der Teilkomponente. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtzahl der Teilkomponenten ist, die einer bestimmten Komponente zugeordnet sind. Der Wert von n wird von IVssComponent::GetRestoreSubcomponentCount zurückgegeben.
[out] pbstrLogicalPath
Zeiger auf eine Zeichenfolge, die den logischen Pfad des Teilkomponentens enthält. Der logische Pfad darf beim Arbeiten mit Unterkomponenten nicht leer sein.
[out] pbstrComponentName
Zeiger auf eine Zeichenfolge, die den Namen des Teilkomponentens enthält. Die Zeichenfolge darf nicht leer sein.
[out] pbRepair
Für die zukünftige Verwendung reserviert.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Das angegebene Element wurde nicht gefunden. |
Hinweise
Der Aufrufer sollte den Arbeitsspeicher der Parameter pbstrLogicalPath und pbstrComponentName durch Aufrufen von SysFreeString freigeben.
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 (enthalten Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |