Funzione CreateVssExamineWriterMetadata (vsbackup.h)

Articolo
08/27/2023

La funzione CreateVssExamineWriterMetadata crea un oggetto IVssExamineWriterMetadata .

Nota Questa funzione viene esportata come CreateVssExamineWriterMetadataInternal, ma è consigliabile chiamare CreateVssExamineWriterMetadata, non CreateVssExamineWriterMetadataInternal.

Sintassi

HRESULT CreateVssExamineWriterMetadata(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

Parametri

[in] bstrXML

Stringa XML contenente un documento metadati writer con cui inizializzare l'oggetto IVssExamineWriterMetadata restituito.

[out] ppMetadata

Variabile che riceve un puntatore dell'interfaccia IVssExamineWriterMetadata all'oggetto.

Valore restituito

I valori restituiti elencati di seguito sono oltre ai normali HRESULT COM che possono essere restituiti in qualsiasi momento dalla funzione.

Valore	Significato
S_OK	È stato restituito un puntatore a un'interfaccia IVssExamineWriterMetadata .
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente o altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Il documento XML passato nel parametro bstrXML non è valido, ovvero non è una stringa XML formattata correttamente o non corrisponde allo schema.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

Per salvare una copia del documento di metadati writer di un writer in una stringa XML per passare il parametro bstrXML , usare il metodo IVssExamineWriterMetadata::SaveAsXML .

Per recuperare la versione più recente del documento metadati writer di un writer, usare il metodo IVssBackupComponents::GetWriterMetadata .

Per caricare un documento di metadati writer in un oggetto IVssExamineWriterMetadata esistente, usare il metodo IVssExamineWriterMetadata::LoadFromXML.

Gli utenti non devono tentare di modificare il contenuto del documento metadati writer.

L'applicazione chiamante è responsabile della chiamata a IUnknown::Release per rilasciare le risorse mantenute dall'oggetto IVssExamineWriterMetadata quando l'oggetto non è più necessario.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib
DLL	VssApi.dll

Vedi anche

IVssExamineWriterMetadata

Condividi tramite