Click or drag to resize

IVssBackupComponentsWriterMetadata Property

A read-only list containing metadata for the writers running on the systsem.

Namespace:  Alphaleonis.Win32.Vss
Assembly:  AlphaVSS.Common (in AlphaVSS.Common.dll) Version: 1.4.0.0 (1.4.0.0)
Syntax
IList<IVssExamineWriterMetadata> WriterMetadata { get; }

Property Value

Type: IListIVssExamineWriterMetadata
A read-only list containing metadata for the writers running on the system.
Caution note Caution
This list must not be accessed after the IVssBackupComponents from which it was obtained has been disposed.
Exceptions
ExceptionCondition
OutOfMemoryExceptionOut of memory or other system resources.
SystemExceptionUnexpected VSS system error. The error code is logged in the event log.
VssBadStateExceptionThe backup components object is not initialized, this method has been called during a restore operation, or this method has not been called within the correct sequence.
VssInvalidXmlDocumentExceptionThe XML document is not valid. Check the event log for details.
VssObjectNotFoundExceptionThe specified shadow copy does not exist.
Remarks

A requester must call the asynchronous operation GatherWriterMetadata and wait for it to complete prior to using WriterMetadata.

Although GatherWriterMetadata must be called prior to either a restore or backup operation, WriterMetadata is not typically used for restores.

Component information retrieved (during backup operations) using Components, where the IVssExamineWriterMetadata instance has been returned by WriterMetadata, comes from the Writer Metadata Document of a live writer process.

This is in contrast to the information returned by WriterComponents (during restore operations), which was stored in the Backup Components Document by calls to AddComponent(Guid, Guid, VssComponentType, String, String).

See Also