Método CWiauPropertyList::D efineProperty (wiautil.h)
El método CWiauPropertyList::D efineProperty agrega una definición de propiedad a un objeto de lista de propiedades.
Sintaxis
HRESULT DefineProperty(
int *pIdx,
PROPID PropId,
LPOLESTR PropName,
ULONG Access,
ULONG SubType
);
Parámetros
pIdx
Puntero a una ubicación de memoria que recibe el índice de la propiedad recién agregada. Muchos otros métodos de esta clase usan el índice de una propiedad para identificar la propiedad .
PropId
Especifica una constante de identificador de propiedad.
PropName
Puntero a una cadena de nombre para la propiedad.
Access
Especifica el tipo de acceso para la propiedad, normalmente WIA_PROP_READ (solo lectura) o WIA_PROP_RW (lectura y escritura).
SubType
Especifica el subtipo de propiedad, uno de WIA_PROP_FLAG, WIA_PROP_LIST, WIA_PROP_RANGE o WIA_PROP_NONE. Las tres primeras constantes indican, respectivamente, que una propiedad es un conjunto de valores de marca, una lista de valores o un intervalo de valores. La cuarta constante indica que una propiedad no es ninguna de estas.
Valor devuelto
Este método devuelve S_OK si puede definir correctamente una propiedad. Si la lista de propiedades no tiene espacio suficiente para una propiedad adicional, el método devuelve E_FAIL.
Comentarios
Para poder agregar una propiedad a una lista de propiedades, se debe inicializar la lista de propiedades. Para ello, llame al método CWiauPropertyList::Init .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiautil.h (incluye Wiautil.h, Wiamindr.h) |