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

Vedi anche

CWiauPropertyList

CWiauPropertyList::Init