wiasWriteMultiple function (wiamdef.h)

The wiasWriteMultiple function writes multiple property values to a WIA item.

Syntax

HRESULT wiasWriteMultiple(
  [in] BYTE              *pWiasContext,
       ULONG             ulCount,
  [in] const PROPSPEC    *ps,
       const PROPVARIANT *pv
);

Parameters

[in] pWiasContext

Pointer to a WIA item context.

ulCount

Specifies the total number of properties to write.

[in] ps

Pointer to the first element of an array of PROPSPEC structures that indicate the properties to write.

pv

Pointer to the first element of an array of PROPVARIANT structures that contain the values to write to the item.

Return value

On success, the function returns S_OK. If the function fails, it returns a standard COM error or one of the WIA_ERROR_XXX errors (described in the Microsoft Windows SDK documentation).

Remarks

This function operates in a similar manner to IPropertyStorage::WriteMultiple, which is described in the Windows SDK documentation. The PROPSPEC and PROPVARIANT structures are also described in the Windows SDK documentation.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows Me and in Windows XP and later versions of the Windows operating systems.
Target Platform Desktop
Header wiamdef.h (include Wiamdef.h)
Library Wiaservc.lib
DLL Wiaservc.dll

See also

wiasReadMultiple