Função wiasReadPropGuid (wiamdef.h)

Artigo
02/07/2025

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 definido como FALSE, a propriedade não precisa existir.

Valor de retorno

Com ê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 (descritos na documentação do SDK do Microsoft Windows).

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	wiamdef.h (inclua Wiamdef.h)
biblioteca	Wiaservc.lib
de DLL	Wiaservc.dll

Consulte também

wiasReadPropBin

wiasReadPropFloat

wiasReadPropLong

wiasReadPropStr

wiasWritePropGuid

Partilhar via