CreateVssExamineWriterMetadata function (vsbackup.h)

The CreateVssExamineWriterMetadata function creates an IVssExamineWriterMetadata object.

Note  This function is exported as CreateVssExamineWriterMetadataInternal, but you should call CreateVssExamineWriterMetadata, not CreateVssExamineWriterMetadataInternal.



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


[in] bstrXML

An XML string containing a Writer Metadata Document with which to initialize the returned IVssExamineWriterMetadata object.

[out] ppMetadata

A variable that receives an IVssExamineWriterMetadata interface pointer to the object.

Return value

The return values listed here are in addition to the normal COM HRESULTs that may be returned at any time from the function.

Value Meaning
Successfully returned a pointer to an IVssExamineWriterMetadata interface.
The caller does not have sufficient backup privileges or is not an administrator.
One of the parameters is not valid.
Out of memory or other system resources.
The XML document passed in the bstrXML parameter is not valid—that is, either it is not a correctly formed XML string or it does not match the schema.
Unexpected error. The error code is logged in the error log file. For more information, see Event and Error Handling Under VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP:  This value is not supported until Windows Server 2008 R2 and Windows 7. E_UNEXPECTED is used instead.


To save a copy of a writer’s Writer Metadata Document into an XML string to pass in the bstrXML parameter, use the IVssExamineWriterMetadata::SaveAsXML method.

To retrieve the latest version of a writer’s Writer Metadata Document, use the IVssBackupComponents::GetWriterMetadata method.

To load a writer metadata document into an existing IVssExamineWriterMetadata object, use the IVssExamineWriterMetadata::LoadFromXML method.

Users should not attempt to modify the contents of the Writer Metadata Document.

The calling application is responsible for calling IUnknown::Release to release the resources held by the IVssExamineWriterMetadata object when the object is no longer needed.


Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Library VssApi.lib
DLL VssApi.dll

See also