IWiaPropertyStorage::SetPropertyStream method (wia_xp.h)

The IWiaPropertyStorage::SetPropertyStream sets the property stream of an item in the tree of IWiaItem objects of a Windows Image Acquisition (WIA) hardware device.

Syntax

HRESULT SetPropertyStream(
  [in] GUID    *pCompatibilityId,
  [in] IStream *pIStream
);

Parameters

[in] pCompatibilityId

Type: GUID*

Specifies a unique identifier for a set of property values.

[in] pIStream

Type: IStream*

Pointer to the property stream that is used to set the current item's property stream.

Return value

Type: HRESULT

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

Remarks

Applications use the pCompatibilityID parameter to check whether a device supports a specific set of property values before attempting to write these values to the device.

Set pIStream to NULL to check whether the device driver accepts the CompatibilityID specified by pCompatibilityID.

If the application obtained the property stream of the item using the IWiaPropertyStorage::GetPropertyStream method, the application must release it. For more information, see IStream.

Requirements

See also

IPropertyStorage

IWiaPropertyStorage