wiasReadPropGuid function (wiamdef.h)

The wiasReadPropGuid function retrieves a GUID property value from a WIA item.

Syntax

HRESULT wiasReadPropGuid(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           GUID   *pguidVal,
  [out, optional] GUID   *pguidValOld,
                  BOOL   bMustExist
);

Parameters

[in] pWiasContext

Pointer to a WIA item context.

propid

Specifies the property identifier.

[out] pguidVal

Pointer to a memory location that receives the GUID property value.

[out, optional] pguidValOld

Pointer to a memory location that receives the previous value of the GUID property data. If this information is not needed, this parameter can be set to NULL.

bMustExist

Indicates whether the property must exist. If set to TRUE, the property must exist; if set to FALSE, the property does not have to exist.

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).

Requirements

Requirement Value
Target Platform Desktop
Header wiamdef.h (include Wiamdef.h)
Library Wiaservc.lib
DLL Wiaservc.dll

See also

wiasReadPropBin

wiasReadPropFloat

wiasReadPropLong

wiasReadPropStr

wiasWritePropGuid