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 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 di 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 è 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.
Commenti
Prima di poter aggiungere una proprietà a un elenco di proprietà, è necessario inizializzare l'elenco delle proprietà. Eseguire questa operazione chiamando il metodo CWiauPropertyList::Init .
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiautil.h (include Wiautil.h, Wiamindr.h) |