IWiaPropertyStorage::GetPropertyAttributes-Methode (wia_xp.h)

Die IWiaPropertyStorage::GetPropertyAttributes-Methode ruft Zugriffsrechte und Rechtliche Wertinformationen für einen angegebenen Satz von Eigenschaften ab.

Syntax

HRESULT GetPropertyAttributes(
  [in]  ULONG          cpspec,
  [in]  PROPSPEC []    rgpspec,
  [out] ULONG []       rgflags,
  [out] PROPVARIANT [] rgpropvar
);

Parameter

[in] cpspec

Typ: ULONG

Gibt die Anzahl der zu abfragenden Eigenschaftenattribute an.

[in] rgpspec

Typ: PROPSPEC[]

Gibt ein Array von Geräteinformationseigenschaftenkonstanten an. Jede Konstante im Array wählt eine zu abfragende Eigenschaft aus.

[out] rgflags

Typ: ULONG[]

Ein Array, das einen Eigenschaftsattributdeskriptor für jede Eigenschaft empfängt, die im rgpspec-Array angegeben ist. Jedes Element im Array ist ein oder mehrere Deskriptorwerte, die mit einem bitweisen OR-Vorgang kombiniert werden.

[out] rgpropvar

Typ: PROPVARIANT[]

Ein Array, das einen Eigenschaftsattributdeskriptor für jede im pPROPSPEC-Array angegebene Eigenschaft empfängt. Weitere Informationen finden Sie unter PROPVARIANT.

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen der folgenden Werte oder einen COM-Standardfehlercode zurück:

Rückgabewert	Bedeutung
S_OK	Diese Methode war erfolgreich.
S_FALSE	Die angegebenen Eigenschaftennamen sind nicht vorhanden. Es wurden keine Attribute abgerufen.
STG_E_ACCESSDENIED	Die Anwendung hat keinen Zugriff auf den Eigenschaftenstream, oder der Stream ist möglicherweise bereits geöffnet.
STG_E_INSUFFICIENTMEMORY	Es steht nicht genügend Arbeitsspeicher zur Verfügung, um den Vorgang durchzuführen.
ERROR_NOT_SUPPORTED	Der Eigenschaftstyp wird nicht unterstützt.
STG_E_INVALIDPARAMETER	Mindestens ein Parameter ist ungültig. Mindestens eine der PROPSPEC-Strukturen enthalten ungültige Daten.
STG_E_INVALIDPOINTER	Mindestens ein zeiger, der an diese Methode übergeben wird, ist ungültig.
ERROR_NO_UNICODE_TRANSLATION	Fehler bei der Übersetzung von Unicode in ANSI oder ANSI in Unicode.

Hinweise

Diese Methode ruft sowohl Eigenschaftenzugriffsrechte als auch gültige Eigenschaftswerte ab. Zugriffsrechte geben an, ob die Eigenschaft lesbar, beschreibbar oder beides ist. Gültige Eigenschaftswerte werden als Wertebereich, Eine Liste von Werten oder eine Gruppe von Flagwerten angegeben. Weitere Informationen finden Sie unter Eigenschaftenattribute.

Wenn für das Kennzeichen der Eigenschaftszugriffsrechte das WIA_PROP_NONE Bit festgelegt ist, stehen für diese Eigenschaft keine Informationen zu rechtlichen Werten zur Verfügung. Schreibgeschützte Eigenschaften und Eigenschaften mit einem binären Datentyp sind Beispiele für Eigenschaften, bei denen das WIA_PROP_NONE Bit festgelegt wäre.

Wenn die -Eigenschaft über einen Bereich gültiger Werte verfügt, können sie nach Abschluss dieser Methode über den rgpropvar-Parameter bestimmt werden. Der ppvValidValues-Parameter gibt ein Array von PROPVARIANT-Strukturen an.

Wenn der Eigenschaftenbereich beispielsweise als VT_VECTOR | VT_UI4 können Bereichsinformationen über das Strukturelement abgerufen werden.

rgpropvar[n].caul.pElems[range_specifier]

wobei n die Indexnummer der überprüften Eigenschaft und range_specifier eine der folgenden Ist:

Bereichsbezeichner	Bedeutung
WIA_RANGE_MAX	Maximaler Wert, auf den die Eigenschaft festgelegt werden kann.
WIA_RANGE_MIN	Mindestwert, auf den die Eigenschaft festgelegt werden kann.
WIA_RANGE_NOM	Normal- oder Standardeigenschaftswert.
WIA_RANGE_STEP	Inkrement oder Dekrement zwischen Eigenschaftswerten.

 

Wenn die -Eigenschaft über eine Liste gültiger Werte verfügt, bestimmen Anwendungen diese nach Abschluss dieser Methode über den Parameter ppvValidValues .

Wenn der Eigenschaftenbereich beispielsweise als VT_VECTOR | VT_UI4 kann die Liste der gültigen Eigenschaftswerte über das Strukturelement abgerufen werden.

rgpropspecValues[n].caul.pElems[list_specifier]

wobei n die Indexnummer der überprüften Eigenschaft ist und list_specifier eine der folgenden ist:

Bereichsbezeichner	Bedeutung
WIA_LIST_COUNT	Gesamtanzahl der Listenelemente ohne Nennwert.
WIA_LIST_NOM	Nominalwert für die Eigenschaft.
WIA_LIST_VALUES	Die Indexnummer des ersten Werts.

 

Programme verwenden auch den ppvValidValues-Parameter , um gültige Flagwerte abzurufen. Wenn die Eigenschaftsflags für instance als VT_UI4 angegeben werden, können gültige Flagwerte über das Strukturmember bestimmt werden.

rgpropspec[n].caul.pElems[flag_specifier]

wobei n die Indexnummer der überprüften Eigenschaft ist, und flag_specifier ist eine der folgenden:

Bereichsbezeichner	Bedeutung
WIA_FLAG_NOM	Der Nominalwert für die Eigenschaft.
WIA_FLAG_NUM_ELEMS	Gesamtanzahl der Listenelemente ohne Nennwert.
WIA_FLAG_VALUES	Alle Werte mit allen gültigen Flagbits festgelegt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (einschließlich Wia.h)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Weitere Informationen

IPropertyStorage

IWiaPropertyStorage