Função wiasGetChangedValueGuid (wiamdef.h)

Artigo
02/27/2024

A função wiasGetChangedValueGuid determina se uma propriedade com um valor GUID foi alterada por um aplicativo.

Sintaxe

HRESULT wiasGetChangedValueGuid(
  [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 de WIA_PROPERTY_CONTEXT que contém o contexto da 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.