wiasIsPropChanged-Funktion (wiamdef.h)

Artikel
02/27/2024

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.