Click or drag to resize
IVssBackupComponentsWriterComponents Property
A read-only list containing information about the components of each writer that has been stored in a requester's Backup Components Document.

Namespace: Alphaleonis.Win32.Vss
Assembly: AlphaVSS.Common (in AlphaVSS.Common.dll) Version: 1.3.0.0 (1.3.0.0)
Syntax
IList<IVssWriterComponents> WriterComponents { get; }

Property Value

Type: IListIVssWriterComponents
A read-only list containing information about the components of each writer that has been stored in a requester's Backup Components Document.
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.
Remarks

WriterComponents retrieves component information for a component stored in the Backup Components Document by earlier calls to AddComponent(Guid, Guid, VssComponentType, String, String).

The information in the components stored in the Backup Components Document is not static. If a writer updates a component during a restore, that change will be reflected in the component retrieved by WriterComponents. This is in contrast with component information found in the IVssWMComponent object returned by Components. That information is read-only and comes from the Writer Metadata Document of a writer process.

The IVssWriterComponents instances that are returned should not be cached, because the following IVssBackupComponents methods cause the instances that are returned by WriterComponents to be no longer valid:

If you call one of these methods after you have retrieved a IVssWriterComponents instance by calling WriterComponents, you cannot reuse that instance, because it is no longer valid. Instead, you must call WriterComponents again to retrieve a new IVssWriterComponents instance.

See Also