Metodo CWiauPropertyList::D efineProperty (wiautil.h)
Il metodo CWiauPropertyList::D efineProperty aggiunge una definizione di proprietà a un oggetto elenco di proprietà.
Sintassi
HRESULT DefineProperty(
int *pIdx,
PROPID PropId,
LPOLESTR PropName,
ULONG Access,
ULONG SubType
);
Parametri
pIdx
Puntatore a una posizione di memoria che riceve l'indice per la proprietà appena aggiunta. Molti altri metodi in questa classe usano l'indice di una proprietà per identificare la proprietà.
PropId
Specifica una costante ID proprietà.
PropName
Puntatore a una stringa del nome per la proprietà .
Access
Specifica il tipo di accesso per la proprietà, in genere WIA_PROP_READ (sola lettura) o WIA_PROP_RW (lettura/scrittura).
SubType
Specifica il sottotipo di proprietà, uno dei WIA_PROP_FLAG, WIA_PROP_LIST, WIA_PROP_RANGE o WIA_PROP_NONE. Le prime tre costanti indicano, rispettivamente, che una proprietà è un set di valori flag, un elenco di valori o un intervallo di valori. La quarta costante indica che una proprietà non è una di queste.
Valore restituito
Questo metodo restituisce S_OK se è in grado di definire correttamente una proprietà. Se l'elenco delle proprietà non dispone di spazio sufficiente per una proprietà aggiuntiva, il metodo restituisce E_FAIL.
Osservazioni
Prima di poter aggiungere una proprietà a un elenco di proprietà, è necessario inizializzare l'elenco delle proprietà. A tale scopo, chiamare il metodo CWiauPropertyList::Init.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wiautil.h (include Wiautil.h, Wiamindr.h) |