Compartilhar via


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

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wiamdef.h (inclua Wiamdef.h)
Biblioteca Wiaservc.lib
DLL Wiaservc.dll

Confira também

wiasReadPropBin

wiasReadPropFloat

wiasReadPropLong

wiasReadPropStr

wiasWritePropGuid