IDestinationStreamFactory interface
Applies to: desktop apps only
Exposes a method for manually copying a stream or file before applying changes to properties.
Members
The IDestinationStreamFactory interface inherits from the IUnknown interface. IDestinationStreamFactory also has these types of members:
Methods
The IDestinationStreamFactory interface has these methods.
| Method | Description |
|---|---|
| GetDestinationStream |
Gets an empty stream that receives the new version of the file being copied. |
Remarks
The default copy-on-write behavior provided by IPropertyStore causes the entire source stream to be duplicated during a write operation. This can be costly for large streams, especially when a large portion of the stream is to be changed. IDestinationStreamFactory provides an alternative for the property handler author, who can use it manually to ensure that property changes do not corrupt the stream in case of failure. To do this, the author marks the handler as NoTransactedMode in the handler's CoClass registry key, and queries the stream for this interface.
Requirements
|
Minimum supported client | Windows Vista |
|---|---|
|
Minimum supported server | Windows Server 2008 |
|
Header |
|
|
IDL |
|
See also
Send comments about this topic to Microsoft
Build date: 3/7/2012
