Leer en inglés

Compartir a través de


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