Metode IWiaPropertyStorage::GetPropertyAttributes (wia_xp.h)

Artikel
08/27/2023

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

IPropertyStorage

IWiaPropertyStorage

Bagikan melalui