IVssBackupComponentsEx::GetWriterMetadataEx-Methode (vsbackup.h)
Die GetWriterMetadataEx-Methode gibt die Metadaten für einen bestimmten Writer zurück, instance auf dem System ausgeführt werden.
Syntax
HRESULT GetWriterMetadataEx(
[in] UINT iWriter,
[out] VSS_ID *pidInstance,
[out] IVssExamineWriterMetadataEx **ppMetadata
);
Parameter
[in] iWriter
Index des Writers, dessen Metadaten abgerufen werden sollen. Der Wert dieses Parameters ist eine ganze Zahl von 0 bis einschließlich n–1, wobei n die Gesamtzahl der Autoren im aktuellen System ist. Der Wert von n wird von der IVssBackupComponents::GetWriterMetadataCount-Methode zurückgegeben.
[out] pidInstance
Adresse einer vom Aufrufer zugewiesenen Variablen, die den instance Bezeichner des Writers empfängt, der die Metadaten erfasst hat.
[out] ppMetadata
Doppelt indirekter Zeiger auf die instance des IVssExamineWriterMetadataEx-Objekts, das die zurückgegebenen Metadaten enthält.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Erfolgreich einen Zeiger auf ein IVssExamineWriterMetadataEx-Schnittstellenobjekt zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Der iWriter-Parameter verweist nicht auf einen gültigen Writer. |
|
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
GetWriterMetadataEx ist identisch mit der IVssBackupComponents::GetWriterMetadata-Methode , mit der Ausnahme, dass sie einen IVssExamineWriterMetadataExdata-Schnittstellenzeiger anstelle eines IVssExamineWriterMetadata-Schnittstellenzeigers im ppMetadata-Parameter zurückgibt.
Ein Anforderer muss die asynchrone IVssBackupComponents::GatherWriterMetadata-Methode aufrufen und warten, bis sie abgeschlossen ist, bevor GetWriterMetadataEx aufgerufen wird.
Obwohl die GatherWriterMetadata-Methode vor einem Wiederherstellungs- oder Sicherungsvorgang aufgerufen werden muss, wird GetWriterMetadataEx normalerweise nicht für Wiederherstellungen aufgerufen.
Komponenteninformationen, die (bei Sicherungsvorgängen) mithilfe der IVssExamineWriterMetadata::GetComponent-Methode abgerufen werden, bei der die IVssExamineWriterMetadataEx-Schnittstelle von GetWriterMetadataEx zurückgegeben wurde, stammen aus dem Writer Metadata Document eines Live Writer-Prozesses.
Dies steht im Gegensatz zu den Von GetWriterComponents (während Wiederherstellungsvorgängen) zurückgegebenen Informationen, die im Dokument der Sicherungskomponenten durch Aufrufe der IVssBackupComponents::AddComponent-Methode gespeichert wurden.
Wenn der Aufrufer dieser Methode den Zugriff auf die Metadaten abgeschlossen hat, muss er IUnknown::Release aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |