wiasReadPropStr-Funktion (wiamdef.h)
Die wiasReadPropStr--Funktion ruft einen Zeichenfolgeneigenschaftswert aus einem WIA-Element ab.
Syntax
HRESULT wiasReadPropStr(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BSTR *pbstr,
[out, optional] BSTR *pbstrOld,
BOOL bMustExist
);
Parameter
[in] pWiasContext
Zeiger auf einen WIA-Elementkontext.
propid
Gibt den Eigenschaftenbezeichner an.
[out] pbstr
Zeigen Sie auf einen Speicherspeicherort, der das erste Byte des Zeichenfolgenwerts der Eigenschaft empfängt.
[out, optional] pbstrOld
Zeigen Sie auf einen Speicherspeicherort, der das erste Byte des vorherigen Werts 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 TRUE-festgelegt ist, muss die Eigenschaft vorhanden sein; wenn dieser Wert 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).
Bemerkungen
Wenn der Minidriver die von dieser Funktion empfangene Zeichenfolge verwendet hat, muss er den für die Zeichenfolge verwendeten Speicher neu zuweisen.
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 |