IDestinationStreamFactory::GetDestinationStream method (shobjidl_core.h)

Gets an empty stream that receives the new version of the file being copied.

Syntax

HRESULT GetDestinationStream(
  [out] IStream **ppstm
);

Parameters

[out] ppstm

Type: IStream**

The address of a pointer to the new stream.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The property handler author calls IDestinationStreamFactory::GetDestinationStream to get a new empty stream that the new version of the file will write to. The handler builds the destination stream manually, copying from the source stream as necessary.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)