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
Zeigen Sie auf einen Speicherspeicherort, der den Wert der Eigenschaft empfängt.
[out, optional] plValOld
Zeigen Sie 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 dieser Wert auf TRUEfestgelegt 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, wird ein STANDARDMÄßIGer COM-Fehler oder einer der WIA_ERROR_XXX Fehler zurückgegeben (in der Microsoft Windows SDK-Dokumentation beschrieben).
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows Me und in Windows XP und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | wiamdef.h (include Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL- | Wiaservc.dll |