wiasGetChangedValueGuid-Funktion (wiamdef.h)

Artikel
02/27/2024

Die wiasGetChangedValueGuid-Funktion bestimmt, ob eine Eigenschaft mit einem GUID-Wert von einer Anwendung geändert wurde.

Syntax

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

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

[in] pContext

Zeiger auf eine WIA_PROPERTY_CONTEXT-Struktur , die den aktuellen Eigenschaftenkontext enthält.

bNoValidation

Gibt an, ob der aktuelle Wert der Eigenschaft anhand ihrer gültigen Werte überprüft werden soll. Wenn dieser Parameter auf TRUE festgelegt ist, führt die Funktion keine Überprüfung für die -Eigenschaft aus. Wenn der Wert FALSE ist, führt die Funktion die Datenüberprüfung durch.

propID

Gibt den Eigenschaftenbezeichner der getesteten Eigenschaft an.

pInfo

Zeiger auf eine WIAS_CHANGED_VALUE_INFO-Struktur , die die aktuellen und vorherigen Werte der Eigenschaft enthält.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.

Hinweise

Der Treiber sollte die Eigenschaft erst überprüfen, nachdem der Treiber die Werte der Eigenschaft aktualisiert hat. Der Treiber aktualisiert die Werte aufgrund von Eigenschaftenänderungen, die von der Anwendung angefordert werden.