Método IPortableDeviceProperties::GetValues (portabledeviceapi.h)

Artículo
08/25/2023

El método GetValues recupera una lista de propiedades especificadas de un objeto especificado en un dispositivo.

Sintaxis

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Parámetros

[in] pszObjectID

Puntero a una cadena terminada en null que contiene el identificador del objeto que se va a consultar. Para especificar el dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] pKeys

Puntero a una interfaz IPortableDeviceKeyCollection que contiene una o varias propiedades para consultar. Si es NULL, se recuperarán todas las propiedades. Consulte Propiedades y atributos para obtener una lista de propiedades definidas por dispositivos portátiles de Windows.

[out] ppValues

Dirección de una variable que recibe un puntero a una interfaz IPortableDeviceValues que contiene los valores de propiedad solicitados. Se devolverán como pares PROPERTYKEY/value, donde el tipo de datos del valor depende de la propiedad . Si un valor no se pudo recuperar por algún motivo, el tipo devuelto será VT_ERROR y contendrá un valor HRESULT que describa el error de recuperación. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella.

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	Se recuperaron todos los valores de propiedad solicitados.
S_FALSE	No se pudieron recuperar uno o más valores de propiedad. Las propiedades del problema tendrán un valor HRESULT en el parámetro ppValues recuperado.