wiasGetChangedValueStr-Funktion (wiamdef.h)

Artikel
02/07/2025

Die wiasGetChangedValueStr--Funktion bestimmt, ob eine Eigenschaft mit einem Zeichenfolgenwert von einer Anwendung geändert wurde.

Syntax

HRESULT wiasGetChangedValueStr(
  [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 seiner gültigen Werte überprüft werden soll. Wenn dieser Parameter auf TRUEfestgelegt ist, führt die Funktion keine Überprüfung für die Eigenschaft durch. Wenn es FALSE-ist, führt die Funktion die Datenüberprüfung aus.

propID

Gibt den Eigenschaftenbezeichner der getesteten Eigenschaft an.

pInfo

Zeigen Sie 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, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.

Bemerkungen

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