Método ISensor::GetProperties (sensorsapi.h)
Recupera varias propiedades del sensor.
HRESULT GetProperties(
[in] IPortableDeviceKeyCollection *pKeys,
[out] IPortableDeviceValues **ppProperties
);
[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.
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 |
---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
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). |
|
Se pasó NULL para ppProperties. |
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.
Para obtener un ejemplo de cómo recuperar propiedades de un sensor, consulte Configuración y recuperación de propiedades del sensor.
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 |