IVssComponentEx::GetRestoreName-Methode (vswriter.h)
Ruft den logischen Namen ab, der einer Komponente zugewiesen ist, die wiederhergestellt wird.
Syntax
HRESULT GetRestoreName(
[out] BSTR *pbstrName
);
Parameter
[out] pbstrName
Die Adresse einer caller-zugeordneten Variable, die eine null-beendete breite Zeichenfolge empfängt, die den Wiederherstellungsnamen für die Komponente enthält.
Rückgabewert
Nachfolgend sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer ist nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
Bemerkungen
Die GetRestoreName-Methode kann nur während eines Wiederherstellungsvorgangs aufgerufen werden.
Wenn der Aufruf von GetRestoreName erfolgreich ist, ist der Aufrufer dafür verantwortlich, die Zeichenfolge freizugeben, die im PbstrName-Parameter zurückgegeben wird, indem die SysFreeString-Funktion aufgerufen wird.
Ein Writer gibt an, dass diese Methode unterstützt wird, indem sie das VSS_BS_RESTORE_RENAME-Kennzeichen in der Sicherungsschemamaske festlegen.
Weitere Informationen finden Sie unter Festlegen von VSS-Wiederherstellungsoptionen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [Nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vswriter.h (include Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |