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 vom Aufrufer zugewiesenen Variablen, die eine mit NULL beendete breite Zeichenfolge empfängt, die den Wiederherstellungsnamen für die Komponente enthält.
Rückgabewert
Im Folgenden 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 verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
Hinweise
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 im pbstrName-Parameter zurückgegebene Zeichenfolge durch Aufrufen der SysFreeString-Funktion freizugeben.
Ein Writer gibt an, dass er diese Methode unterstützt, indem er das flag VSS_BS_RESTORE_RENAME in seiner Sicherungsschemamaske festlegt.
Weitere Informationen finden Sie unter Festlegen von VSS-Wiederherstellungsoptionen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vswriter.h (einschließlich Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |