Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |