IVssBackupComponentsEx2::SetAuthoritativeRestore-Methode (vsbackup.h)

Artikel
08/27/2023

Markiert die Wiederherstellung einer Komponente als autoritativ für einen replizierten Datenspeicher.

Syntax

HRESULT SetAuthoritativeRestore(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] bool               bAuth
);

Parameter

[in] writerId

Der globally unique Identifier (GUID) der Writer-Klasse.

[in] ct

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

[in] wszLogicalPath

Eine breite NULL-Zeichenfolge, die den logischen Pfad der Komponente enthält. Weitere Informationen finden Sie unter Logisches Pathing 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 breite NULL-Zeichenfolge, die den Namen der Komponente enthält.

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

[in] bAuth

Legen Sie diese Variable auf true fest, um anzugeben, dass die Wiederherstellung der Komponente autoritativ oder andernfalls false ist.

Der Standardwert ist false.

Rückgabewert

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

Wert	Bedeutung
S_OK	Die Wiederherstellung der Komponente wurde erfolgreich auf autorisierend oder nicht authentifizierend festgelegt.
E_INVALIDARG	Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY	Der Aufrufer verfügt nicht über 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 SetAuthoritativeRestore-Methode kann nur während eines Wiederherstellungsvorgangs aufgerufen werden.

Ein Writer gibt an, dass er die autoritativen Wiederherstellungen unterstützt, indem das flag VSS_BS_AUTHORITATIVE_RESTORE in der Sicherungsschemamaske festgelegt wird.

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

Weitere Informationen

IVssBackupComponents::SetRestoreOptions

IVssBackupComponentsEx2

IVssComponentEx::GetAuthoritativeRestore

VSS_BACKUP_SCHEMA

Freigeben über