Freigeben über


IWsbApplicationBackupSupport::CheckConsistency-Methode (wsbapp.h)

Überprüft die Konsistenz der Komponenten des VSS-Writers in der Schattenkopie, nachdem Schattenkopien für die zu sichernden Volumes erstellt wurden.

Syntax

HRESULT CheckConsistency(
  [in, optional]  LPWSTR               wszWriterMetadata,
  [in, optional]  LPWSTR               wszComponentName,
  [in, optional]  LPWSTR               wszComponentLogicalPath,
  [in]            DWORD                cVolumes,
  [in, optional]  LPWSTR               *rgwszSourceVolumePath,
  [in, optional]  LPWSTR               *rgwszSnapshotVolumePath,
  [out, optional] IWsbApplicationAsync **ppAsync
);

Parameter

[in, optional] wszWriterMetadata

Eine Zeichenfolge, die die Metadaten des VSS-Writers enthält.

[in, optional] wszComponentName

Der Name der zu überprüfenden Komponente oder Komponente. Dies sollte mit dem Namen in den Metadaten übereinstimmen, auf den der wszWriterMetadata-Parameter verweist.

[in, optional] wszComponentLogicalPath

Der logische Pfad der zu überprüfenden Komponente oder Komponente. Dies sollte mit dem logischen Pfad in den Metadaten übereinstimmen, auf den der wszWriterMetadata-Parameter verweist.

[in] cVolumes

Die Anzahl der Schattenkopievolumes. Der Wert dieses Parameters kann zwischen 0 und MAX_VOLUMES liegen.

[in, optional] rgwszSourceVolumePath

Ein Zeiger auf ein Array von Volume-GUID-Pfaden , einer für jedes Quellvolumes. Das Format eines Volume-GUID-Pfads ist "\?\Volume{GUID}".

[in, optional] rgwszSnapshotVolumePath

Ein Zeiger auf ein Array von Volume-GUID-Pfaden , einer für jedes Schattenkopievolumes. Die Konsistenzprüfung wird auf diesen Volumes durchgeführt.

[out, optional] ppAsync

Ein Zeiger auf eine Variable, die einen IWsbApplicationAsync-Schnittstellenzeiger empfängt, mit dem die status des Vorgangs zur Konsistenzprüfung abgerufen werden kann. Dieser Zeiger kann NULL sein, wenn keine Konsistenzprüfung erforderlich ist. Wenn der Vorgang zur Konsistenzprüfung abgeschlossen ist, muss die IUnknown::Release-Methode aufgerufen werden, um alle ressourcen des IWsbApplicationAsync-Objekts freizugeben.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Folgende Rückgabewerte sind möglich.

Hinweise

Die Anwendung sollte die Konsistenzprüfung als asynchronen Vorgang durchführen, da es sich um einen Vorgang mit langer Ausführungsdauer handelt. Die Anwendung sollte die Konsistenz der Dateien für die Komponenten des VSS-Writers in der Schattenkopie überprüfen. Diese Dateien werden im Rahmen des Sicherungsvorgangs gesichert. Wenn die Konsistenzprüfung fehlschlägt, ist die Sicherung der Komponenten weiterhin erfolgreich, aber die Wiederherstellung der Komponenten ist aus dem resultierenden Sicherungssatz nicht zulässig.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wsbapp.h

Weitere Informationen

IWsbApplicationBackupSupport