IVssBackupComponents::GatherWriterMetadata-Methode (vsbackup.h)

  • Artikel

Die GatherWriterMetadata-Methode fordert jeden Writer auf, die gesammelten Metadaten zu senden. Die -Methode generiert ein Identify-Ereignis für die Kommunikation mit Writern.

Syntax

HRESULT GatherWriterMetadata(
  [out] IVssAsync **pAsync
);

Parameter

[out] pAsync

Doppelt indirekter Zeiger auf ein IVssAsync-Objekt , das die Writermetadaten enthält.

Rückgabewert

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

Wert Bedeutung
S_OK
 Es wurde erfolgreich ein Zeiger auf eine instance der IVssAsync-Schnittstelle zurückgegeben. Die gültigen Werte, die vom pHrResult-Parameter zurückgegeben werden, finden Sie unter IVssAsync::QueryStatus.
E_ACCESSDENIED
 Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_INVALIDARG
 ppAsync zeigt nicht auf einen gültigen Zeiger. Das heißt, es ist NULL.
E_OUTOFMEMORY
 Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE
 Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen.
VSS_E_WRITER_INFRASTRUCTURE
 Die Writer-Infrastruktur funktioniert nicht ordnungsgemäß. Überprüfen Sie, ob der Ereignisdienst und VSS gestartet wurden, und überprüfen Sie im Fehlerprotokoll auf Fehler, die diesen Diensten zugeordnet sind.
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

Der Aufrufer ist für die Freigabe der IVssAsync-Schnittstelle verantwortlich.

GatherWriterMetadata sollte nur einmal während der Lebensdauer eines bestimmten IVssBackupComponents-Objekts aufgerufen werden.

GatherWriterMetadata generiert ein Identify-Ereignis, das von jeder instance jedes Writers über die CVssWriter::OnIdentify-Methode behandelt wird, die zum Ausfüllen des Writer-Metadatendokuments verwendet wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

CVssWriter::OnIdentify

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents