wiasIsPropChanged-Funktion (wiamdef.h)

Die wiasIsPropChanged-Funktion testet , ob eine angegebene Eigenschaft von einer Anwendung geändert wurde.

Syntax

HRESULT wiasIsPropChanged(
        PROPID               propid,
  [in]  WIA_PROPERTY_CONTEXT *pContext,
  [out] BOOL                 *pbChanged
);

Parameter

propid

Gibt den Eigenschaftsbezeichner der zu überprüfenden Eigenschaft an.

[in] pContext

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

[out] pbChanged

Zeiger auf einen Speicherspeicherort, der einen BOOL-Wert empfängt. Der BOOL-Wert ist TRUE , wenn sich die Eigenschaft geändert hat, und FALSE , wenn sich die Eigenschaft nicht geändert hat.

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

Diese Funktion bestimmt, ob eine Eigenschaft geändert wird, indem sie den bChanged-Memberwert in der WIA_PROPERTY_CONTEXT Struktur der Eigenschaft betrachtet. Minidriver verwenden diese Funktion in der Regel, um zu überprüfen, wann eine unabhängige Eigenschaft geändert wurde, damit ihre abhängigen Elemente aktualisiert werden können.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile wiamdef.h (einschließlich Wiamdef.h)
Bibliothek Wiaservc.lib
DLL Wiaservc.dll

Weitere Informationen

WIA_PROPERTY_CONTEXT

wiasGetChangedValueFloat

wiasGetChangedValueGuid

wiasGetChangedValueLong

wiasGetChangedValueStr