Função wiasGetChangedValueStr (wiamdef.h)

Artigo
02/27/2024

A função wiasGetChangedValueStr determina se uma propriedade com um valor de cadeia de caracteres foi alterada por um aplicativo.

Sintaxe

HRESULT wiasGetChangedValueStr(
  [in] BYTE                    *pWiasContext,
  [in] WIA_PROPERTY_CONTEXT    *pContext,
       BOOL                    bNoValidation,
       PROPID                  propID,
       WIAS_CHANGED_VALUE_INFO *pInfo
);

Parâmetros

[in] pWiasContext

Ponteiro para um contexto de item WIA.

[in] pContext

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

bNoValidation

Indica se o valor atual da propriedade deve ser validado em relação ao conjunto de valores válidos. Se esse parâmetro for definido como TRUE, a função não executará a validação na propriedade . Se for FALSE, a função executará a validação de dados.

propID

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

pInfo

Ponteiro para uma estrutura WIAS_CHANGED_VALUE_INFO que contém os valores atuais e anteriores da propriedade.

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 códigos de erro WIA.

Comentários

O driver deve validar a propriedade somente depois que o driver tiver atualizado os valores da propriedade. O driver atualiza os valores como resultado de alterações de propriedade solicitadas pelo aplicativo.