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 da propriedade atual.

bChanged

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

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

Comentários

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
Cliente mínimo com suporte Disponível no Microsoft Windows Me e no Windows XP e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho wiamdef.h (inclua Wiamdef.h)
Biblioteca Wiaservc.lib
DLL Wiaservc.dll

Confira também

WIA_PROPERTY_CONTEXT

wiasIsPropChanged