Compartilhar via


Função wiasSetPropChanged (wiamdef.h)

A função wiasSetPropChanged modifica um contexto de propriedade para indicar que uma propriedade está sendo alterada.

Sintaxe

HRESULT wiasSetPropChanged(
       PROPID               propid,
  [in] WIA_PROPERTY_CONTEXT *pContext,
       BOOL                 bChanged
);

Parâmetros

propid

Especifica o identificador de propriedade da propriedade que está sendo alterada.

[in] pContext

Ponteiro para uma estrutura de WIA_PROPERTY_CONTEXT que contém o contexto de propriedade atual.

bChanged

Especifica o valor BOOL usado para definir um elemento específico na matriz apontada pelo membro pChanged de uma estrutura WIA_PROPERTY_CONTEXT. Consulte a seção Comentários para obter mais detalhes.

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

Observações

O membro pChanged da estrutura WIA_PROPERTY_CONTEXT aponta para uma matriz de valores BOOL que indicam se uma propriedade específica será alterada. Essa função define um elemento nessa matriz para a propriedade especificada no contexto da propriedade. Essa função deve ser usada sempre que um driver altera uma propriedade que tem propriedades dependentes na validação. Por exemplo, alterando "Intenção Atual", a "Resolução Horizontal" é alterada e deve ser marcada como alterada, de modo que a validação de "Resolução X" (WIA_IPS_XRES)e seus dependentes ainda ocorram.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Microsoft Windows Me e no Windows XP e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino Área de trabalho
cabeçalho wiamdef.h (inclua Wiamdef.h)
biblioteca Wiaservc.lib
de DLL Wiaservc.dll

Consulte também

WIA_PROPERTY_CONTEXT

wiasIsPropChanged