wiasGetPropertyAttributes-Funktion (wiamdef.h)

Die wiasGetPropertyAttributes-Funktion ruft die Zugriffsflags und gültigen Werte für eine Reihe von Eigenschaften ab.

Syntax

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

cPropSpec

Gibt die Anzahl der Eigenschaften an.

[in] pPropSpec

Zeiger auf eine PROPSPEC-Struktur , die die Eigenschaften angibt, für die gültige Werte und Zugriffsflags abgerufen werden sollen.

pulAccessFlags

Zeiger auf ein Array, das die Zugriffsflags für die Eigenschaften enthält.

[out] pPropVar

Zeiger auf ein Array von PROPVARIANT-Strukturen , das die gültigen Werte für die Eigenschaften enthält.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.

Hinweise

Diese Funktion füllt jedes Element des pPropVar-Arrays mit einer PROPVARIANT-Struktur, die die gültigen Werte für die entsprechende Eigenschaft angibt. Eigenschaften mit dem Zugriffsberechtigungsflag WIA_PROP_NONE keine gültigen Werte für diese Eigenschaft aufweisen. Der Datentyp für die gültigen Werte dieser Eigenschaften ist VT_EMPTY.

Ein oder mehrere der WIA_PROP_Xxx Eigenschaftenattribute und Zugriffsflags können in jedem Element des pulAccessFlags-Arrays zurückgegeben werden.

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

Auf gültige ganzzahlige Werte und Gleitkommawerte in einem Bereich wird mithilfe der folgenden Indexkonstanten zugegriffen.

Auf gültige Listenwerte wird mithilfe der folgenden Indexkonstanten zugegriffen.

Auf gültige bitweise Flagwerte wird mithilfe der folgenden Indexkonstanten zugegriffen.

Anforderungen