Metode IWiaPropertyStorage::GetPropertyAttributes (wia_xp.h)
Metode IWiaPropertyStorage::GetPropertyAttributes mengambil hak akses dan informasi nilai hukum untuk sekumpulan properti tertentu.
Sintaks
HRESULT GetPropertyAttributes(
[in] ULONG cpspec,
[in] PROPSPEC [] rgpspec,
[out] ULONG [] rgflags,
[out] PROPVARIANT [] rgpropvar
);
Parameter
[in] cpspec
Jenis: ULONG
Menentukan jumlah atribut properti untuk kueri.
[in] rgpspec
Jenis: PROPSPEC[]
Menentukan array Konstanta Properti Informasi Perangkat. Setiap konstanta dalam array memilih properti untuk dikueri.
[out] rgflags
Jenis: ULONG[]
Array yang menerima deskriptor atribut properti untuk setiap properti yang ditentukan dalam array rgpspec . Setiap elemen dalam array adalah satu atau beberapa nilai deskriptor yang dikombinasikan dengan operasi OR bitwise.
[out] rgpropvar
Jenis: PROPVARIANT[]
Array yang menerima deskriptor atribut properti untuk setiap properti yang ditentukan dalam array pPROPSPEC . Untuk informasi selengkapnya, lihat PROPVARIANT.
Nilai kembali
Jenis: HRESULT
Metode ini mengembalikan salah satu nilai berikut atau kode kesalahan COM standar:
Tampilkan Nilai | Makna |
---|---|
S_OK | Metode ini berhasil. |
S_FALSE | Nama properti yang ditentukan tidak ada. Tidak ada atribut yang diambil. |
STG_E_ACCESSDENIED | Aplikasi tidak memiliki akses ke aliran properti atau aliran mungkin sudah terbuka. |
STG_E_INSUFFICIENTMEMORY | Tidak ada cukup memori untuk menyelesaikan operasi. |
ERROR_NOT_SUPPORTED | Tipe properti tidak didukung. |
STG_E_INVALIDPARAMETER | Satu atau beberapa parameter tidak valid. Satu atau beberapa struktur PROPSPEC berisi data yang tidak valid. |
STG_E_INVALIDPOINTER | Satu atau beberapa pointer yang diteruskan ke metode ini tidak valid. |
ERROR_NO_UNICODE_TRANSLATION | Terjemahan dari Unicode ke ANSI atau ANSI ke Unicode gagal. |
Keterangan
Metode ini mengambil hak akses properti dan nilai properti yang valid. Hak akses melaporkan apakah properti dapat dibaca, dapat ditulis, atau keduanya. Nilai properti yang valid ditentukan sebagai rentang nilai, daftar nilai, atau grup nilai bendera. Untuk informasi selengkapnya, lihat Atribut Properti.
Jika bendera hak akses properti memiliki set bit WIA_PROP_NONE , tidak ada informasi nilai hukum yang tersedia untuk properti ini. Baca saja properti dan properti dengan jenis data biner adalah contoh properti yang akan memiliki kumpulan bit WIA_PROP_NONE .
Jika properti memiliki rentang nilai yang valid, mereka dapat ditentukan melalui parameter rgpropvar setelah menyelesaikan metode ini. Parameter ppvValidValues menentukan array struktur PROPVARIANT .
Misalnya, jika rentang properti ditentukan sebagai VT_VECTOR | VT_UI4, informasi rentang dapat diambil melalui anggota struktur
rgpropvar[n].caul.pElems[range_specifier]
di mana n adalah nomor indeks properti yang diperiksa dan range_specifier adalah salah satu dari berikut ini:
Penentu Rentang | Makna |
---|---|
WIA_RANGE_MAX | Nilai maksimum yang dapat diatur properti. |
WIA_RANGE_MIN | Nilai minimum tempat properti dapat diatur. |
WIA_RANGE_NOM | Nilai properti normal atau default. |
WIA_RANGE_STEP | Kenaikan atau penurunan antar nilai properti. |
Jika properti memiliki daftar nilai yang valid, aplikasi menentukannya melalui parameter ppvValidValues setelah menyelesaikan metode ini.
Misalnya, jika rentang properti ditentukan sebagai VT_VECTOR | VT_UI4, daftar nilai properti yang valid dapat diambil melalui anggota struktur
rgpropspecValues[n].caul.pElems[list_specifier]
di mana n adalah nomor indeks properti yang diperiksa dan list_specifier adalah salah satu dari berikut ini:
Penentu Rentang | Makna |
---|---|
WIA_LIST_COUNT | Jumlah total elemen daftar yang tidak termasuk nilai nominal. |
WIA_LIST_NOM | Nilai nominal untuk properti . |
WIA_LIST_VALUES | Nomor indeks dari nilai pertama. |
Program juga menggunakan parameter ppvValidValues untuk mengambil nilai bendera yang valid. Misalnya, jika bendera properti ditentukan sebagai VT_UI4, nilai bendera yang valid dapat ditentukan melalui anggota struktur
rgpropspec[n].caul.pElems[flag_specifier]
di mana n adalah nomor indeks properti yang diperiksa, dan flag_specifier adalah salah satu dari berikut ini:
Penentu Rentang | Makna |
---|---|
WIA_FLAG_NOM | Nilai nominal untuk properti . |
WIA_FLAG_NUM_ELEMS | Jumlah total elemen daftar yang tidak termasuk nilai nominal. |
WIA_FLAG_VALUES | Semua nilai dengan semua bit bendera yang valid diatur. |
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional, Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | wia_xp.h (termasuk Wia.h) |
Pustaka | Wiaguid.lib |
DLL | Wiaservc.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk