fungsi wiasReadPropStr (wiamdef.h)
Fungsi wiasReadPropStr mengambil nilai properti string dari item WIA.
Sintaks
HRESULT wiasReadPropStr(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BSTR *pbstr,
[out, optional] BSTR *pbstrOld,
BOOL bMustExist
);
Parameter
[in] pWiasContext
Arahkan ke konteks item WIA.
propid
Menentukan pengidentifikasi properti.
[out] pbstr
Penunjuk ke lokasi memori yang menerima byte pertama dari nilai string properti.
[out, optional] pbstrOld
Penunjuk ke lokasi memori yang menerima byte pertama dari nilai properti sebelumnya. Jika informasi ini tidak diperlukan, atur parameter ini ke NULL.
bMustExist
Menunjukkan apakah properti harus ada. Jika diatur ke TRUE, properti harus ada; jika diatur ke FALSE, properti tidak harus ada.
Mengembalikan nilai
Jika berhasil, fungsi mengembalikan S_OK. Jika fungsi gagal, fungsi mengembalikan kesalahan COM standar atau salah satu kesalahan WIA_ERROR_XXX (dijelaskan dalam dokumentasi Microsoft Windows SDK).
Keterangan
Ketika minidriver telah selesai menggunakan string yang diterimanya dari fungsi ini, itu harus membatalkan alokasi memori yang digunakan untuk string.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows Me dan di Windows XP dan versi sistem operasi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | wiamdef.h (termasuk Wiamdef.h) |
| Pustaka | Wiaservc.lib |
| DLL | Wiaservc.dll |