Funzione wiasGetPropertyAttributes (wiamdef.h)

Articolo
08/08/2023

La funzione wiasGetPropertyAttributes recupera i flag di accesso e i valori validi per un set di proprietà.

Sintassi

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

Parametri

[in] pWiasContext

Puntatore a un contesto di elemento WIA.

cPropSpec

Specifica il numero di proprietà.

[in] pPropSpec

Puntatore a una struttura PROPSPEC che indica le proprietà per cui ottenere valori e flag di accesso validi.

pulAccessFlags

Puntatore a una matrice che contiene i flag di accesso per le proprietà.

[out] pPropVar

Puntatore a una matrice di strutture PROPVARIANT che contiene i valori validi per le proprietà.

Valore restituito

In caso di esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore WIA.

Commenti

Questa funzione riempie ogni elemento della matrice pPropVar con una struttura PROPVARIANT che specifica i valori validi per la proprietà corrispondente. Le proprietà con il flag di diritti di accesso WIA_PROP_NONE non hanno valori validi per tale proprietà. Il tipo di dati per i valori validi di queste proprietà è VT_EMPTY.

È possibile restituire uno o più attributi della proprietà WIA_PROP_Xxx e i flag di accesso in ogni elemento della matrice pulAccessFlags .

Se la proprietà ha un intervallo di valori validi, è possibile determinare i valori tramite il parametro pPropVar al completamento di questa funzione. Il parametro pPropVar specifica una matrice di strutture PROPVARIANT.

È possibile accedere a valori interi e a virgola mobile validi in un intervallo usando le costanti di indice seguenti.

Indice di valore valido	Descrizione
WIA_RANGE_MIN	Valore minimo
WIA_RANGE_NOM	Valore nominale
WIA_RANGE_MAX	Valore massimo
WIA_RANGE_STEP	Valore di incremento

È possibile accedere ai valori di elenco validi usando le costanti di indice seguenti.

Indice di valore valido	Descrizione
WIA_LIST_COUNT	Conteggio dei valori di elenco validi, senza contare il valore nominale
WIA_LIST_NOM	Valore nominale
WIA_LIST_VALUES	Indice al primo valore valido

È possibile accedere ai valori dei flag bit per bit validi usando le costanti di indice seguenti.

Indice di valore valido	Descrizione
WIA_FLAG_NOM	Valore nominale
WIA_FLAG_VALUES	Tutti i flag validi vengono uniti da un operatore OR

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	wiamdef.h (include Wiamdef.h)
Libreria	Wiaservc.lib
DLL	Wiaservc.dll

Condividi tramite