IVssBackupComponentsEx2::SetRestoreName-Methode (vsbackup.h)

Artikel
08/27/2023

Weist einer Komponente, die wiederhergestellt wird, einen neuen logischen Namen zu.

Syntax

HRESULT SetRestoreName(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszRestoreName
);

Parameter

[in] writerId

Die GUID (Globally Unique Identifier) der Writer-Klasse.

[in] ct

Der Typ der Komponente. Die möglichen Werte finden Sie in der VSS_COMPONENT_TYPE-Enumeration .

[in] wszLogicalPath

Eine mit NULL endende Breitzeichenzeichenfolge, die den logischen Pfad der Komponente enthält. Weitere Informationen finden Sie unter Logische Pfade von Komponenten.

Der Wert der Zeichenfolge, die den hier verwendeten logischen Pfad enthält, sollte mit der Zeichenfolge identisch sein, die beim Hinzufügen der Komponente verwendet wurde.

Der logische Pfad kann NULL sein.

Es gibt keine Einschränkungen für die Zeichen, die in einem logischen Pfad ohne NULL angezeigt werden können.

[in] wszComponentName

Eine mit NULL endende Breitzeichenzeichenfolge, die den Namen der Komponente enthält.

Die Zeichenfolge darf nicht NULL sein und sollte denselben Komponentennamen wie der Komponentenname enthalten, der verwendet wurde, als die Komponente dem Sicherungssatz mithilfe der IVssBackupComponents::AddComponent-Methode hinzugefügt wurde.

[in] wszRestoreName

Eine mit NULL beendete Breitzeichenzeichenfolge, die den Wiederherstellungsnamen enthält, der für die Komponente festgelegt werden soll.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert	Bedeutung
S_OK	Der Wiederherstellungsname wurde erfolgreich festgelegt.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE	Diese Methode wurde während eines Wiederherstellungsvorgangs nicht aufgerufen.
VSS_E_OBJECT_NOT_FOUND	Die angegebene Komponente wurde nicht gefunden.
VSS_E_UNEXPECTED	Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet.

Hinweise

Die SetRestoreName-Methode kann nur während eines Wiederherstellungsvorgangs aufgerufen werden.

Ein Writer gibt an, dass diese Methode unterstützt wird, indem das flag VSS_BS_RESTORE_RENAME in der Sicherungsschemamaske festgelegt wird.

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	vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek	VssApi.lib

Weitere Informationen

IVssBackupComponentsEx2

IVssComponentEx::GetRestoreName

VSS_BACKUP_SCHEMA

Freigeben über