Método ISensor::GetProperties (sensorsapi.h)

Recupera varias propiedades del sensor.

Sintaxis

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

Parámetros

[in] pKeys

Puntero a una interfaz IPortableDeviceKeyCollection que contiene la colección PROPERTYKEY para los valores de propiedad que se solicitan. Establezca en NULL para recuperar todas las propiedades admitidas.

[out] ppProperties

Dirección de un puntero IPortableDeviceValues que recibe el puntero a los valores de propiedad solicitados.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
S_FALSE	El controlador del sensor no admite al menos una de las propiedades especificadas. Cada propiedad no admitida PROPVARIANT devuelta a través de la interfaz IPortableDeviceValues tendrá su valor de error establecido en HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER	Se pasó NULL para ppProperties.

Comentarios

Este método permite recuperar los valores de varias propiedades, como la marca del sensor, el modelo y el número de serie, realizando una sola llamada. Para recuperar una sola propiedad, llame a ISensor::GetProperty.

Las interfaces IPortableDeviceKeyCollection e IPortableDeviceValues se definen mediante la API de dispositivos portátiles de Windows.

Ejemplos

Para obtener un ejemplo de cómo recuperar propiedades de un sensor, consulte Configuración y recuperación de propiedades del sensor.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	sensorsapi.h
Library	Sensorsapi.lib
Archivo DLL	Sensorsapi.dll

Consulte también

ISensor

Propiedades del sensor

SetProperties