IVssBackupComponents::GatherWriterMetadata-Methode (vsbackup.h)
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 |
|---|---|
|
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. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
ppAsync zeigt nicht auf einen gültigen Zeiger. Das heißt, es ist NULL. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
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. |
|
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 |