Função wiasReadPropGuid (wiamdef.h)

A função wiasReadPropGuid recupera um valor de propriedade GUID de um item WIA.

Sintaxe

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

Parâmetros

[in] pWiasContext

Ponteiro para um contexto de item WIA.

propid

Especifica o identificador de propriedade.

[out] pguidVal

Ponteiro para um local de memória que recebe o valor da propriedade GUID.

[out, optional] pguidValOld

Ponteiro para um local de memória que recebe o valor anterior dos dados da propriedade GUID. Se essas informações não forem necessárias, esse parâmetro poderá ser definido como NULL.

bMustExist

Indica se a propriedade deve existir. Se definido como TRUE, a propriedade deverá existir; se definida como FALSE, a propriedade não precisará existir.

Retornar valor

Em caso de êxito, a função retorna S_OK. Se a função falhar, ela retornará um erro COM padrão ou um dos erros de WIA_ERROR_XXX (descrito na documentação do SDK do Microsoft Windows).

Requisitos

Confira também

wiasReadPropBin

wiasReadPropFloat

wiasReadPropLong

wiasReadPropStr

wiasWritePropGuid