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 CreateVssExamineWriterMetadata-Funktion erstellt ein IVssExamineWriterMetadata-Objekt .
Hinweis Diese Funktion wird als CreateVssExamineWriterMetadataInternal exportiert. Sie sollten jedoch CreateVssExamineWriterMetadata und nicht CreateVssExamineWriterMetadataInternal aufrufen.
Syntax
HRESULT CreateVssExamineWriterMetadata(
[in] BSTR bstrXML,
[out] IVssExamineWriterMetadata **ppMetadata
);
Parameter
[in] bstrXML
Eine XML-Zeichenfolge, die ein Writer Metadata Document enthält, mit dem das zurückgegebene IVssExamineWriterMetadata-Objekt initialisiert werden soll.
[out] ppMetadata
Eine Variable, die einen IVssExamineWriterMetadata-Schnittstellenzeiger auf das Objekt empfängt.
Rückgabewert
Die hier aufgeführten Rückgabewerte sind zusätzlich zu den normalen COM HRESULTs, die jederzeit von der Funktion zurückgegeben werden können.
| Wert | Bedeutung |
|---|---|
|
Erfolgreich einen Zeiger auf eine IVssExamineWriterMetadata-Schnittstelle zurückgegeben. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Einer der Parameter ist ungültig. |
|
Nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das im bstrXML-Parameter übergebene XML-Dokument ist ungültig, d. h. es handelt sich entweder nicht um eine ordnungsgemäß formatierte XML-Zeichenfolge oder es stimmt nicht mit dem Schema überein. |
|
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
Verwenden Sie die IVssExamineWriterMetadata::SaveAsXML-Methode, um eine Kopie des Writer-Metadatendokuments eines Writers in einer XML-Zeichenfolge zu speichern, die im bstrXML-Parameter übergeben werden soll.
Verwenden Sie die IVssBackupComponents::GetWriterMetadata-Methode , um die neueste Version des Writer-Metadatendokuments abzurufen.
Verwenden Sie die IVssExamineWriterMetadata-Methode, um ein Writer-Metadatendokument in ein vorhandenes IVssExamineWriterMetadata::LoadFromXML-Objekt zu laden.
Benutzer sollten nicht versuchen, den Inhalt des Writer-Metadatendokuments zu ändern.
Die aufrufende Anwendung ist für den Aufruf von IUnknown::Release verantwortlich, um die ressourcen des IVssExamineWriterMetadata-Objekts freizugeben, wenn das Objekt nicht mehr benötigt 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 (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |
| DLL | VssApi.dll |