wiasReadPropLong-Funktion (wiamdef.h)

Die wiasReadPropLong-Funktion ruft einen langen ganzzahligen Eigenschaftswert aus einem WIA-Element ab.

Syntax

HRESULT wiasReadPropLong(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           LONG   *plVal,
  [out, optional] LONG   *plValOld,
                  BOOL   bMustExist
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

propid

Gibt den Eigenschaftenbezeichner an.

[out] plVal

Zeiger auf einen Speicherspeicherort, der den Wert der Eigenschaft empfängt.

[out, optional] plValOld

Zeiger auf einen Speicherspeicherort, der den vorherigen Wert der Eigenschaft empfängt. Wenn diese Informationen nicht benötigt werden, legen Sie diesen Parameter auf NULL fest.

bMustExist

Gibt an, ob die Eigenschaft vorhanden sein muss. Wenn sie auf TRUE festgelegt ist, muss die Eigenschaft vorhanden sein. Wenn sie auf FALSE festgelegt ist, muss die Eigenschaft nicht vorhanden sein.

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_ERROR_XXX Fehler zurück (in der Microsoft Windows SDK-Dokumentation beschrieben).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows Me und in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile wiamdef.h (einschließlich Wiamdef.h)
Bibliothek Wiaservc.lib
DLL Wiaservc.dll

Weitere Informationen

wiasReadPropBin

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropStr

wiasWritePropLong